DateRange

DateRange - элемент управления, предназначенный для выбора периода с помощью календаря или клавиатуры.

Свойства

id

Идентификатор контрола.

Отнаследовано от Control.

hint

Всплывающая подсказка, которая появляется при наведении на контрол.

Отнаследовано от Control.

tags

Позволяет объединять контролы в группы, возвращает массив имен.

Отнаследовано от Control.

captionWidth

Ширина заголовка в колонках (для Bootstrap-верстки).

отнаследовано от Control

editorWidth

Ширина контрола в колонках (для Bootstrap-верстки).

отнаследовано от Control

captionTextAlign

тип	значение по умолчанию	допустимые значения
string	left	left/right

Выравнивание текста заголовка контрола (доступно с версии 3.26.0)

denyRoles

Список ролей без прав на данный элемент.

Отнаследовано от Control.

readRoles

Список ролей на чтение данных.

отнаследовано от Control.

writeRoles

Список ролей на изменение данных.

отнаследовано от Control.

visible

Видимость контрола.

Отнаследовано от Control.

width

Ширина контрола.

Отнаследовано от Control.

caption

тип	значение по умолчанию	допустимые значения
string	-

Заголовок контрола

placeholder

тип	значение по умолчанию	допустимые значения
string	-

Вспомогательный текст в поле ввода контрола.

bind

тип	значение по умолчанию	допустимые значения
string	-

Свойство, к которому биндится контрол.

Необходимо задать дату начала и дату окончания. Имя свойства разделяется через символ ;. Пример: "bdate;edate"

value

тип	значение по умолчанию	допустимые значения
object	-

Позволяет получить/задать период.

Свойство нельзя назначить из шаблона формы. Значение представляет собой объект со свойствами: bdate - начальная дата, edata - конечная дата.

enabled

тип	значение по умолчанию	допустимые значения
bool	true	true/false

Доступность контрола для редактирования

readOnly

тип	значение по умолчанию	допустимые значения
bool	false	true/false

Режим "только для чтения"

format

тип	значение по умолчанию	допустимые значения
string	dd.MM.yyyy

Формат отображения даты

min

тип	значение по умолчанию	допустимые значения
date	1900-01-01

Минимальная дата, которая доступна для выбора.

В шаблоне формы задается в виде строки формата yyyy-MM-dd

max

тип	значение по умолчанию	допустимые значения
date	2100-01-01

Максимальная дата, которая доступна для выбора.

В шаблоне формы задается в виде строки формата yyyy-MM-dd

Методы

focus

Устанавливает фокус на контрол.

Отнаследовано от Control.

События

valueChanged

Возникает при смене значения.

таблицаобъект

параметр	тип	описание
s	DateRange	экземпляр класса контрола
e	object
e.args	object	аргументы события
e.args.bdate	Date	начальная дата в контроле
e.args.edate	Date	конечная дата в контроле

s = DateTimeInput {
    ... // экземпляр класса DateRange
},
e = {
    args: {
        bdate: 'Mon Jan 01 2024 00:00:00 GMT+0500',
        edate: 'Mon Jan 31 2024 00:00:00 GMT+0500'
    }
}

Пример

myForm.xmlmyForm.js

<DateRange ... valueChanged='DateRangeExample_valueChanged' />

DateRangeExample_valueChanged(s, e) {
    console.log('s', s)
    console.log('e', e)
}

Форматирование даты для отображения

Смотри статью Форматирование данных

См. также

Дата и время в Lexema.ru

---