Дата

Назначение

Дата - это компонента, которая используетсядля ввода или отображения даты или даты-времени.

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

Для сохранения информации в базу данных и отображения значения из базы данных (в данном случае, функция компоненты Дата. Сохранение значения должна быть включена)
Для отображения значения, которое был введено пользователем приложения или является константой, определённой в логике приложения (в данном случае, функция компоненты Дата. Сохранение значения должна быть выключена или удалена через настройки функции по кнопке).

Компонента Дата находится в разделе Компоненты - Поля - Дата.

Свойства

Компонента имеет набор общих свойств. Ниже отображены свойства, специфичные только для данной компоненты.

Наименование свойства	Назначение свойства	Принимаемые значения
Формат	позволяет задать формат для вывода	Только дата (в данном случае, значение в поле будет отображаться без времени) Дата со временем
Подсказка	позволяет создать подсказку, расположенную внутри элемента	пример возможного значения: Введите год
Надпись	позволяет задать наименование поля, которое будет отображаться на странице	пример возможного значения: Год
Значение	позволяет задать статичное значение поля по умолчанию для отображения на странице, состоящее из двух частей: значения даты и значения времени (часы, минуты и секунды) (значение времени будет отображаться на пользовательской странице при условии, что в свойстве элемента Формат указано Дата со временем)	пример возможного значения: 23.03.2021 11:11:11
Тип минимальной даты	позволяет выбрать тип настройки для указания минимально допустимого значения даты в поле	Статичное (STATIC) - при выборе данного типа отображается свойство для заполненияМинимальная дата Текущая (CURRENT) - при выборе данного типа в качестве минимально допустимого значения для ввода будет текущая дата хоста, на котором работает браузер пользователя Другой объект (OTHER_OBJECT) - при выборе данного типа отображается свойство Объект для минимальной даты (Min Date Object)
Тип максимальной даты	позволяет выбрать тип настройки для указания максимально допустимого значения даты в поле	Статичное (STATIC) - при выборе данного типа отображается свойство для заполненияМаксимальная дата Текущая (CURRENT) - при выборе данного типа в качестве минимально допустимого значения для ввода будеттекущая дата хоста, на котором работает браузер пользователя Другой объект (OTHER_OBJECT) - при выборе данного типа отображается свойство Объект для максимальной даты (Max Date Object)
Минимальная дата	позволяет задать статичное минимально возможное значение даты, меньше которого пользователь ввести не сможет. Указание данного значения доступно, если в свойстве Тип для минимального значения (Min Date Type) выбрано - Статичное (STATIC). Минимальное значение состоит из двух частей: значения даты и значения времени (часы, минуты и секунды)(значение времени будет учитываться при условии, в свойстве элементаФормат указано Дата со временем)	пример возможного значения: 23.03.2021 11:11:11
Обьект минимальной даты	позволяет указать объект (компоненту) с типом Дата на настраиваемой странице, значение которой будет выступать в качестве минимально допустимого значения даты для ввода пользователем.	Указание данного значения доступно, если в свойстве Тип для минимального значения (Min Date Type) выбрано -Другой объект (OTHER_OBJECT)
Максимальная дата	позволяет задать статичное максимально возможное значение даты, больше которого пользователь ввести не сможет. Указание данного значения доступно, если в свойстве Тип для максимального значения (Max Date Type) выбрано - Статичное (STATIC). Максимальное значение состоит из двух частей: значения даты и значения времени (часы, минуты и секунды)(значение времени будет учитываться при условии, в свойстве элементаФормат указано Дата со временем)	пример возможного значения: 31.12.2017 11:11:11
Обьект максимальной даты	позволяет указать объект (компоненту) с типом Дата на настраиваемой странице, значение которой будет выступать в качестве максимально допустимого значения даты для ввода пользователем. Указание данного значения доступно, если в свойстве Тип для максимального значения (Max Date Type)выбрано -Другой объект (OTHER_OBJECT)
В виде календаря	позволяет задать возможность отображения элемента на странице в виде развернутого календаря	Принимает два значения: Активно - элемент на странице будет отображаться в виде календаря с возможностью выбора даты Не активно - элемент на странице будет отображаться в виде поля для ручного ввода значения или выбора значения из календаря

Свойство Дата. Сохранение значения

В случае, если значение в поле Дата необходимо сохранить или подгрузить из базы данных, указывается поле таблицы базы данных, куда будет сохраняться и откуда будет подгружаться введенное значение. Для выбора доступны только колонки имеющие тип в базе данных - Даты и времени (DATETIME, DATE и TIMESTAMP).В случае, если значение поля Дата не требуется сохранять или подгружать из базы данных, то данное свойство удаляется (или отключается). Данный вариант может быть необходим, когда поле используется дляотображения значения, которое было введено пользователем приложения или является константой, определённой в логике приложения.

Базовые функции

Заполнить значением по умолчанию

Заполнить значением из переменной процесса

Дополнительные функции

В ходе настройки свойств компоненты (заданных по умолчанию) может оказаться недостаточно для выполнения поставленной задачи и получения необходимого результата.

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

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

Определить права текущего пользователя

Определить роли текущего пользователя

Определить_роли_текущего_пользователя

Сохранить значение в переменную процесса любого типа

Сместить дату из поля на период вперед или назад

Определить текущую дату и сместить её вперед или назад на заданный период

Она относится к той группе функций, чья функциональность применяется и может быть полезной не сразу после добавления в исходную компоненту, а только при последующем использовании в компоненте “Обработка событий”, когда у исходной компоненты появляется несколько новых доступных методов при конструировании алгоритма обработки событий на web-странице. Например, для такого паттерна обработки: ‘ЕСЛИ в исходном компоненте Дата выбрано(изменилось) значение, ТО в другую компоненту Дата вывести значение из исходного, но на заранее заданный период (или годы, или месяцы, или дни) в будущее или прошлое’. Функция имеет параметры, позволяющие аналитику задать направление и величину сдвига во времени.

Методические рекомендации по применению

Пошаговые инструкции по применению компонента в типовых задачах Вы можете найти в разделах:

Часто задаваемые вопросы

Вопрос	Ответ
Можно ли проставлять текущую серверную дату при открытии страницы с данным полем?	Да, можно. Для этого необходимо добавить соответствующую функцию (Определить текущую дату и сместить её вперед или назад на заданный период) в функции поля. Необходимо отметить, что для проставления текущей даты не нужно заполнять свойства скрипта.
Возникнет ли ошибка при запуске приложения, если оставить незаполненным свойство Дата. Сохранение значения?	Да. В случае, если функция “Дата. Сохранения значения” включена у элемента и не заполнены ее параметры, то при валидации проекта возникнет ошибка. Если по условию задачи данное поле не должно подгружаться и сохраняться в базу данных, данную функцию в компоненте необходимо либо отключить либо удалить.
Если удалить базовые функции, которые включены в компоненту по умолчанию, например, “Заполнить значением по умолчанию” можно ли будет вновь их добавить?	Да. Если удалить какую-то базовую функцию компоненты, то по кнопке “Добавить функцию” она будет доступна для выбора.
Можно ли вносить данные в поле Дата вручную?	Да,ввод значения предусмотрен как с клавиатуры, так и выбор значения по значку в виде календаря.
Обязательно при ручном вводе значения в поле Дата указывать значение с разделителем в виде точки, т.е. 01.01.2021?	Нет, необязательно указывать разделитель между числами. Введя значение 01012021 и убрав фокус с поля оно автоматически отформатируется к виду 01.01.2021.
Можно ли проставлять дату со смещением при открытии страницы с данным полем?	Да,можно. Для этого необходимо добавить соответствующий скрипт (Определить текущую дату и сместить её вперед или назад на заданный период) в функции поля. В данном случае, необходимо заполнить свойства функции и указать необходимый диапазон смещения от текущей даты.
Какое значение будет проставлено в поле Дата если ввести толькоодну часть значения, например, день?	Если ввести только значение дня в поле Дата, то убрав фокус с поля оставшаяся часть месяц и год будут проставлены в соответствии с текущим месяцем и годом на сервере приложения.