Виджет "Средство выбора даты и времени" (с поддержкой тем)
Средство выбора даты и времени позволяет пользователю выбирать значения даты и времени в мэшапе. Во время выполнения пользователи могут задавать даты, выбирая месяц, год и день. Можно также настроить виджет, чтобы включить часы, минуты и секунды. Этот раздел содержит следующие подразделы.
Анатомия виджета
1. Текстовое поле
2. Дата начала
3. Дата окончания
4. Выпадающий список месяцев
5. Выпадающий список лет
6. Метка дня
7. Выбранная дата
Режим выбора диапазона
Чтобы включить выбор диапазона, задайте для конфигурации DateRange значение true. Режим выбора диапазона позволяет пользователю ограничить дату и время в определенном диапазоне. Можно также ограничить выбор диапазона, введя числовое значение в свойстве YearRange.
Выбор времени
По умолчанию средство выбора даты и времени позволяет выбирать даты. Чтобы включить выбор времени, задайте для свойства DateOnly виджета значение false. Отключение свойства позволяет пользователям выбирать время и дату. Чтобы добавить секунды, задайте для свойства DisplaySeconds значение true.
Свойства интервала
Используйте свойство Interval, чтобы сместить выбранное по умолчанию значение относительно текущей даты или времени при открытии календаря. Можно сместить выбранное значение вперед или назад на дни, часы, минуты или секунды, используя свойство IntervalType. Например, чтобы сместить выбранное время в виджете "Средство выбора даты и времени" на 30 минут вперед, задайте для свойства IntervalType значение Минуты, а для свойства Interval значение 30.
Форматирование даты и времени
Дату и время можно форматировать с помощью следующих свойств.
• Свойство DateOrder позволяет задать порядок компонентов даты. По умолчанию порядок компонентов даты автоматически задается во время выполнения в соответствии с языковой настройкой пользователя.
• FormatToken позволяет настраивать формат даты и времени. Свойство FormatToken переопределяет следующие свойства DisplaySeconds, DateDelimiter, DateOnly, MonthFormat и DateOrder.
◦ DisplaySeconds: Свойство DisplaySeconds позволяет пользователям отображать секунды в двух различных форматах.
a. 0:59
b. 00 59.
◦ DateOnly: Свойство DateOnly позволяет пользователям отображать дни месяца в трех форматах.
a. День месяца в виде числа от 1 до 31.
b. День месяца в виде числа от 1 до 31 с падежным окончанием, где первый день - это 1-й, а последний день - это 31-й.
c. Отображает номер дня в интервале от 01 до 31.
◦ DateDelimiter: Свойство DateDelimiter позволяет пользователям использовать один из пяти различных типов символов пунктуации в качестве разделителей между разными единицами измерения времени и даты.
a. 
◦ MonthFormat: Свойство MonthFormat позволяет пользователям отображать месяцы года в одном из пяти различных форматов.
a. Отображает номер месяца в виде диапазона чисел от 1 до 12, где январю соответствует 1, а декабрю - 12.
b. Отображает номер месяца в виде диапазона от 1 до 12 с падежным окончанием, где январь - это 1-й, а декабрь - это 12-й.
c. Отображает номер месяца в виде диапазона от 01 до 12, где январю соответствует 01, а декабрю - 12.
d. Отображает месяц в виде сокращенной строки, например "янв" вместо "январь".
e. Отображает полное название месяца в виде строки: "январь".
◦ DateOrder: Свойство DateOrder: позволяет пользователям задавать порядок компонентов даты одним из трех различных способов.
a. День-месяц-год Это формат по умолчанию
b. Месяц-день-год
c. Год-месяц-день
Дополнительные сведения см. в. разделе Форматирование даты и времени для виджетов.
Свойство | Описание | Базовый тип | Значение по умолчанию | Доступно для привязки? (Д/Н) | Локализуемое? | ||
Label | Текст, который отображен в метке виджета "Средство выбора даты и времени". | STRING | Н/Д | Д | Д | ||
Disabled | Используйте это свойство, чтобы отключить виджет в мэшапе. Виджет будет отображаться в мэшапе, но не будет реагировать на нажатие. | BOOLEAN | FALSE | Д | Н | ||
HintText | Отображает текст местозаполнителя, поясняющий, что именно должно быть введено в поле. | STRING | Выбрать дату и время | Д | Д | ||
DateOnly | Позволяет отображать только дату. | BOOLEAN | TRUE | Н | Н | ||
DisplaySeconds | Позволяет отображать время с секундами. | BOOLEAN | FALSE | Н | Н | ||
DateDelimter | Задает символ, который используется для разделения дня, месяца и года. Например: дефис (-) или косая черта (/), как в 10/05/2020. | STRING | Н/Д | Н | Д | ||
MonthFormat | Позволяет отображать месяц в полном, коротком или числовом формате. | STRING | Полный | Н | Н | ||
PrimaryActionPosition | Позволяет задать положение кнопки основного действия Слева или Справа. Основное действие - это • Готово кнопка в группе кнопок. | STRING | Слева | Н | Н | ||
DateOrder | Позволяет задать формат отображения даты. Различными форматами являются Авто, День-месяц-год, Месяц-день-год и Год-месяц-день Если выбран формат по умолчанию Авто, в виджете отображается системная дата. Кроме того, свойства DateDelimiter и MonthFormat отключаются виджетом. | STRING | АВТО | Н | Н | ||
FormatToken | Если по умолчанию выбрано Авто, для форматирования даты используется языковая настройка пользователя. Это свойство переопределяет свойства DateDelimiter и MonthFormat.
| STRING | Н/Д | Н | Д | ||
IntervalType | Позволяет задать интервалы в Часах, Минутах или Днях.
| STRING | ЧАСЫ | Н | Н | ||
Interval | Позволяет задать тип интервала: Часы, Минуты или Дни.
| NUMBER | 0 | Н | Н | ||
MaxRange | Задает максимальное число дней между датами начала и окончания, которое могут выбрать пользователи.
| NUMBER | Н/Д | Н | Н | ||
MaxRangeFailureMessage | Сообщение, которое отображается, если выбранный диапазон между датами начала и окончания превышает значение MaxRange.
| STRING | Н/Д | Д | Д | ||
CustomClass | Позволяет определить CSS в верхнем разделе виджета. Можно ввести несколько классов, разделенных пробелами. | STRING | Н/Д | Д | Н | ||
TabSequence | Последовательность, в которой подсвечиваются виджеты при нажатии пользователем клавиши табуляции. | NUMBER | Н/Д | Н | Н | ||
WeeklyCalendarStart | Позволяет задать начало недельного календаря с воскресенья или с понедельника. | STRING | ПОНЕДЕЛЬНИК | Н | Н | ||
InitializeWithCurrentDateTime | Позволяет задать текущую дату и время для свойств Дата и Время. Если это свойство не выбрано, необходимо ввести дату и время. | BOOLEAN | TRUE | Н | Н | ||
LabelAlignment | Позволяет выровнять метку в виджете: по левому краю, по правому краю или по центру. | STRING | Слева | Н | Н | ||
DateTime | Источник для значения даты и времени в средстве выбора даты и времени. | DATETIME | Н/Д | Д | Н | ||
Changed | Связываемое событие, которое инициируется, когда изменяются данные этого виджета. | Н/Д | Н/Д | Д | Н | ||
ResetToDefaultValue | Сбрасывает все входные данные для этого виджета до значений по умолчанию. | Н/Д | Н/Д | Д | Н | ||
DateRange | Позволяет задать диапазон дат в годах, месяцах, днях. При выборе этого свойства добавляются следующие свойства: • StartDate • StartDateLabel • EndDate • EndDateLabel • RangeHintText • RangedChanged
| BOOLEAN | false | Н | Н | ||
Width | Ширина виджета. | NUMBER | Н/Д | Н | Н | ||
Height | Высота виджета. Высота по умолчанию равна максимальной ширине метки. Она увеличивается, если виджет содержит многострочную метку. Введите значение на панели свойств или измените размер виджета на канве, чтобы задать фиксированную высоту. | NUMBER | Н/Д | Н | Н | ||
CurrentDateButton | Добавляет кнопку, позволяющую выбрать текущую дату. | BOOLEAN | True | Н | Н | ||
YearRange | Позволяет выбрать диапазон лет для мэшапа. | NUMBER | 10 | Н | Н |
