Функция «год»
Функция год получает год из значения даты и возвращает его в виде целого числа.
Функция пригодится, когда из полной даты необходимо получить только год для дальнейшего использования в выражениях Комбинатора.
Синтаксис
год(дата)
дата — значение, содержащее дату. В функцию можно передать:
- дату, указанную непосредственно в функции;
- значение из поля Дата;
- значение из поля Дата и время;
- значение из поля Текст, если в нём записана дата;
- результат другой функции Комбинатора, содержащий дату.
Указание даты непосредственно в функции
Конкретную дату можно указать непосредственно в функции. Значение необходимо заключить в двойные кавычки.
Например:
год("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