Перейти к содержанию

Поле «Дата»

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

Подходит, например, для даты заключения договора, даты рождения, даты оплаты, даты начала или окончания периода.

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

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

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

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

Поле содержит календарную дату без времени.

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

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

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

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

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

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

Например:

датаДоговора

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

Например:

сделки.датаДоговора

Здесь:

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

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

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

Например:

форматДаты(датаДоговора, ФорматДаты.ДатаКратко)

Например:

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

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

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

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

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

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

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

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

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