Длительность

Книга: «1С:Предприятие.Элемент». Возможности встроенного языка

В языке «1С:Предприятия» отсутствовал тип Длительность.

Теперь в языке «Элемента» существует тип Длительность, который предназначен для работы с интервалами времени. Этот тип хранит количество миллисекунд, описывающих некоторый интервал времени.

Значение типа Длительность можно получить следующим способом:

С помощью конструктора типа, в котором составляющие интервала вводятся отдельными параметрами конструктора. Обязательность указания параметров конструктора зависит от используемого конструктора. Например:

пер Интервал = новый Длительность(5, 7, 25, 44, 111) //результат: 127:25:44.111 (в часах)

пер Интервал = новый Длительность(5, 45, 22) //результат: 05:45:22.000 (в часах)

С помощью литерала, описывающего длительность. Литерал имеет вид [Ад][Бч][Вм][Гс][Дмс]. В этом литерале любой элемент может быть опущен, если соответствующее значение равно нулю. Компоненты означают следующее:
- д – значение дней;
- ч – значение часов;
- м – значение минут;
- с – значение секунд;
- мс – значение миллисекунд.

пер Интервал = 5д14ч30м //результат: 134.30.00.000 (в часах)

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

Например:

Сообщить("%{Дата{2022-06-14} - Дата{2022-06-13}}") //результат: 24:00.00.000

Сообщить("%{Время{15:25:55} - Время{12:20:05}}") //результат: 03:05:50.000

Сообщить("%{Дата{2022-06-14} + 2д}") //результат: 2022-06-16

Сообщить("%{Время{15:25:55} - 3ч5м50с}") //результат: 12:20:05.000

Сообщить("%{Момент{2020-10-25 13:35:55 Z} - Момент{2020-10-22 12:30:55 Z}}") //результат 73:05:00.000

Сообщить("%{Момент{2020-10-25 13:35:55 Z} - 3д1ч5м}") //результат: 2020-10-22T12:30:55.000Z

С помощью свойств и методов экземпляров типа Длительность можно легко выделять различные интервалы. А также представить значение типа Длительность в читаемом формате. Например:

пер Интервал = новый Длительность(7, 25, 44)

Сообщить("%{Интервал.Часы} ч. %{Интервал.Минуты} м. %{Интервал.Секунды} с.")

// Результат: 7 ч. 25 м. 44 с.

Интервал = новый Длительность( 127, 25, 44)

Сообщить("%{Интервал.Дни} д. %{Интервал.Часы} ч. %{Интервал.Минуты} м. %{Интервал.Секунды} с.")

// Результат: 5 д. 7 ч. 25 м. 44 с.

подробнее

Документация:

Синтакс-помощник:

Назад: Методы

Дальше: Коллекции