Поле «Дата/Время»

Поле «Дата/Время» используется для хранения значений, содержащих одновременно дату и время. Значение поля можно выводить в разных форматах и обрабатывать с помощью функций.

Подходит, например, для даты и времени встречи, оформления заказа, создания документа, начала или окончания события.

Создание и добавление поля

Создание и добавление полей: ИНСТРУКЦИЯ.

Создание и добавление полей: ИНСТРУКЦИЯ

Значение поля

Поле содержит одновременно дату и время.

При добавлении поля в шаблон через анкету можно выбрать формат, в котором его значение должно отображаться в сформированном документе. Поэтому одно и то же значение поля может быть выведено в разных форматах.

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

Если необходимо хранить только календарную дату, используйте поле «Дата». Если требуется только время — поле «Время».

Вставка поля через вкладку «Метки»

Значение поля «Дата/Время» можно вставить в шаблон через метку «Значение».

В свойстве «Выражение» указывается поле, значение которого необходимо вывести.

Например:

датаВстречи

При формировании документа метка будет заменена значением этого поля.

Например:

сделки.датаВстречи

Здесь:

• сделки — сущность Битрикс24, из которой берутся данные;
• датаВстречи — поле, содержащее дату и время.

При формировании документа метка будет заменена значением этого поля.

В метке «Значение» можно использовать функции для обработки и форматирования даты и времени.

Например:

форматДаты(датаВстречи, ФорматДаты.ДатаКратко)

Например:

форматДаты(сделки.датаВстречи, ФорматДаты.ДатаКратко)

В этом случае в документ будет выведена только дата в формате, заданном функцией.

Функции для работы с полем

Для поля «Дата/Время» доступны функции для получения отдельных частей значения, изменения даты и форматирования результата.

Получение частей даты и времени

• год — возвращает год;
• месяц — возвращает номер месяца;
• день — возвращает день месяца;
• час — возвращает часы;
• минуты — возвращает минуты;
• секунды — возвращает секунды;
• деньнед — возвращает номер дня недели;
• номнедели — возвращает номер недели.

Изменение даты

• датамес — смещает дату на указанное количество месяцев;
• смещдат — смещает дату на указанное количество дней;
• начмесяца — возвращает дату первого дня месяца;
• конмесяца — возвращает дату последнего дня месяца;
• разндат — вычисляет разницу между датами.

Форматирование

• форматДаты — изменяет формат отображения даты и времени.