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

Функция «год»

Функция год получает год из значения даты и возвращает его в виде целого числа.

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

Синтаксис

год(дата)

дата — значение, содержащее дату. В функцию можно передать:

  • дату, указанную непосредственно в функции;
  • значение из поля Дата;
  • значение из поля Дата и время;
  • значение из поля Текст, если в нём записана дата;
  • результат другой функции Комбинатора, содержащий дату.

Указание даты непосредственно в функции

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

Например:

год("11.08.2026")

Результат:

2026

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

Использование значения из поля

Функция год может получать дату из разных типов полей.

Если поле Дата содержит:

11.08.2026

выражение:

год(полеДата)

вернёт:

2026

Если поле Дата и время содержит:

11.08.2026 14:30:15

выражение:

год(полеДатаВремя)

вернёт:

2026

Функцию можно использовать и с текстовым полем. Если поле Текст содержит:

15.05.2024

выражение:

год(текстовоеПоле)

вернёт:

2024

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

Использование с другими функциями

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

Например, её можно использовать вместе с функцией тдата():

год(тдата())

Функция тдата() возвращает текущие дату и время. Например:

11.08.2026 14:05:25

Функция год получает из этого значения только год.

Результат:

2026