Следующий раздел содержит информацию о данном виджете в ThingWorx 9.3.3 или более поздней версии. Если вы используете более раннюю версию ThingWorx, см. раздел Виджет "Средство выбора даты и времени".

Виджет "Средство выбора даты и времени" позволяет пользователям выбирать в мэшапах одно значение даты или времени или диапазон значений. При запуске этот виджет отображается в свернутом состоянии. Если щелкнуть значок календаря, откроется представление календаря, в котором дни каждого месяца дополнены выпадающими списками для выбора. Выпадающие списки календаря представляют собой комбинированные поля, поддерживающие ввод с клавиатуры. Можно ввести значение для более быстрого выбора элемента. Кнопка календаря открывает всплывающий календарь, позволяющий выбирать даты в интерактивном режиме. В календаре в зависимости от конфигурации средства выбора даты отображаются различные элементы управления. Сконфигурировать виджет можно следующими способами:

Выбор дат сохраняется только при нажатии кнопки Выбрать и не сохраняется при щелчке любой области вне виджета или нажатии клавиши ESC.

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

При выборе диапазона первое выбранное значение используется в качестве начала диапазона. Однако даты переключаются автоматически, если вторая выбранная дата предшествует первой дате, чтобы диапазон остался допустимым. Кроме того, если щелкнуть новую дату, это приведет к очистке существующего диапазона и инициирует выбор нового диапазона.

Диапазон дат, доступный для выбора в календаре, можно ограничить одним из трех способов:

По умолчанию средство выбора даты и времени позволяет выбирать даты. Поддержка выбора времени позволяет пользователям выбирать конкретное время или диапазон времени в дополнение к датам в календаре. Чтобы добавить выбор времени в виджет, задайте для свойства виджета DateOnly значение false. По умолчанию выбор времени сконфигурирован в часах и минутах. Можно разрешить пользователям выбирать секунды, задав для свойства DisplaySeconds значение true. На следующем рисунке показан виджет с поддержкой выбора времени с точностью до секунд.

По умолчанию виджет отображает все даты. Можно использовать свойство MaxRange, чтобы ограничить выбор даты конкретным диапазоном. Например, чтобы задать возможный диапазон 20 дней. Задайте для свойства DateRange значение true, а для свойства MaxRange на панели Проверка - значение 20.

На следующем изображении показано выбранное значение диапазона, а также даты, находящиеся вне диапазона. Диапазон вычисляется во время выполнения после выбора пользователем начальной даты начала или окончания. MaxRange находится в пределах минимальной и максимальной дат начала и окончания. При выборе этой опции даты, находящиеся вне заданного значения, затем отключаются; см. пример номер 3 на изображении.

По умолчанию время отображается в 24-часовом формате. Чтобы отображать время в 12-часовом формате, задайте для свойства виджета TwelveHourClock значение true. Будет отображаться дополнительный выпадающий список для выбора между значениями AM и PM.

Свойство Interval используется для смещения выбранного значения по умолчанию относительно текущей даты или времени, когда виджет отображается во время выполнения. Можно сместить выбранное значение вперед или назад на дни, часы, минуты или секунды, используя свойство IntervalType. Например, чтобы переместить выбранное время в виджете "Средство выбора даты и времени" на 30 минут, задайте для свойства IntervalType значение Минуты, а для свойства Interval значение 30.

По умолчанию порядок дат автоматически задается в соответствии с языковой настройкой пользователя, просматривающего мэшап. Например, в некоторых географических регионах даты отображаются в формате день-месяц-год, а в других используется формат месяц-день-год. Можно вручную задать порядок для всех пользователей с помощью свойства виджета DateOrder. При применении определенного порядка в список свойств добавляются свойства MonthFormat и DateDelimiter.

Можно задать формат даты, настроив свойство виджета FormatToken на основе синтаксиса библиотеки MomentJS. Дополнительные сведения о параметрах форматирования для дат см. в разделе Форматирование даты и времени для виджетов.

По умолчанию виджет отображает строку символов, которая указывает формат даты или времени, поддерживаемый виджетом. Комбинированные поля позволяют пользователям быстрее вводить значение виджета без открытия календаря. Можно отключить маски ввода, задав для свойства DisableMaskedInput значение true. На следующем рисунке показано обновление даты с отображением масок ввода.

В дополнение к общим свойствам можно использовать свойства MaxDate и MinDate, чтобы ограничить доступный диапазон дат в виджете. Если выбирается дата вне диапазона, отображается сообщение о сбое.

Чтобы настроить стандартные сообщения о сбое, используйте свойства MinDateFailureMessage и MaxDateFailureMessage или свойство MaxRangeFailureMessage.

Дополнительные сведения об общих свойствах проверки см. в разделе Применение проверки к виджетам.