Функция «время»

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

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

Например, из часов 14, минут 30 и секунд 0 можно сформировать единое значение времени 14:30:00.

Синтаксис

время(часы, минуты, секунды)

В скобках последовательно указываются:

• часы — целое число от 0 до 23;
• минуты — целое число от 0 до 59;
• секунды — целое число от 0 до 59.

Например:

время(14, 30, 0)

Если какое-либо значение выходит за допустимый диапазон, Комбинатор вернёт ошибку. Например:

время(25, 30, 0)

Такое выражение вызовет ошибку, поскольку значение часов должно находиться в диапазоне от 0 до 23.

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

Результат функции

Функция время технически формирует значение, которое содержит одновременно дату и время.

Поэтому выражение:

время(14, 30, 0)

создаст значение:

01.01.0001 14:30:00

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

Дата 01.01.0001 является технической частью полученного значения.

Как вывести только время

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

Например, значение:

01.01.0001 14:30:00

можно отобразить в документе только как время:

14:30:00

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