QML-тип TimePicker

Циферблат часов для выбора времени. Подробнее…

Строка импорта:	import Sailfish.Silica 1.0
Наследуется от:	Item

• Список всех членов класса, включая унаследованные

Свойства

• hour : int
• hourMode : enumeration
• minute : int
• time : date
• timeText : string

Подробное описание

Тип TimePicker представляет собой элемент управления для выбора времени на циферблате.

Ниже приведён простой пример диалога для выбора времени с текущим значением, установленным на 13:00 (или на 1:30PM в 12-часовом формате):

import Sailfish.Silica 1.0

TimePicker {
    hour: 13
    minute: 30
}

Если значения свойств hour (час) или minute (минута) не установлены, по умолчанию они равны 0.

При изменении времени, отображаемого на циферблате, значения свойств hour и minute соответствующим образом обновляются. Если свойство hourMode установлено в значение DateTime.TwelveHours, значение свойства hour корректируется в соответствии с 12-часовым форматом исчисления времени.

Имеется также специальный тип TimePickerDialog, представляющий собой циферблат, встроенный в окно диалога. В случаях, когда от пользователя требуется всего лишь указать время, то гораздо удобнее использовать тип TimePickerDialog вместо элементов типа TimePicker.

См. также TimePickerDialog и DatePicker.

Описание свойств

hour : int

Значение часа, отображаемого на циферблате.

Если свойство hourMode установлено в значение DateTime.TwentyFourHours, это число в допустимом диапазоне значений 0–23. Если свойство hourMode установлено в значение DateTime.TwelveHours, это число в допустимом диапазоне значений 0–12. Значение по умолчанию: 0.

Если данному свойству устанавливается значение вне границ допустимого диапазона значений, то, в соответствии с текущим значением свойства hourMode, значение свойства hour корректируется до ближайшего допустимого значения.

См. также hourMode.

hourMode : enumeration

Управляет диапазоном допустимых значений для свойства hour. Данное свойство может принимать значение одного из следующих типов:

• DateTime.DefaultHours — используется 24-часовой либо 12-часовой формат исчисления времени в зависимости от системных настроек устройства. Значение по умолчанию;
• DateTime.TwentyFourHours — 24-часовой формат. Диапазон допустимых значений для свойства hour составляет 0–23;
• DateTime.TwelveHours — 12-часовой формат. Диапазон допустимых значений для свойства hour составляет 0–12.

Если значение свойства hour находится в диапазоне 13–23, то при изменении свойства hourMode в значение DateTime.TwelveHours свойство hour будет скорректировано автоматически. Например, значение свойства hour, равное 14, в 12-часовом формате станет равным 2, т.к. время "14:00" в 12-часовом формате представляется как "2:00PM".

minute : int

Значение минуты, отображаемой на циферблате.

Число в диапазоне допустимых значений 0–59. Значение по умолчанию: 0.

Если данному свойству устанавливается значение вне границ допустимого диапазона значений, то значение свойства minute корректируется до ближайшего допустимого значения.

time : date

Возвращает выбранное значение времени в виде JavaScript-объекта date.

Дата этого объекта устанавливается равной 1 января 1970 года.

timeText : string

Выбранная дата в виде строки в формате "hh:mm". Если свойству hourMode установлено значение DateTime.TwelveHours, в конец строки добавляется суффикс AM/PM.

Например, если свойству hour установлено значение 16, свойству minute — значение 30, а свойству hourMode — значение DateTime.TwelveHours, то значением свойства timeText будет "4:30PM". Если же свойство hourMode установлено в значение DateTime.TwentyFourHours, то значением свойства timeText будет "16:30".