Момент

Иерархия типа

graph BT;
Момент-->Представляемое;
Представляемое-->Объект;
Момент-->Сравнимое&ltМомент>
Сравнимое&ltМомент&gt-->Объект;

Момент времени. Представляет значение даты и времени в формате UTC. Максимальное значение 4000-01-01 17:59:59.999 Z. Минимальное значение 0000-12-31 06:00:00.000 Z.

Сравнение структурное. Два экземпляра момента равны, если равны их представления в ДатаВремя в одинаковом часовом поясе.

Литералы

• Момент{<дата><разделитель_сегментов><время><часовой_пояс>}
  • <дата> имеет вид: ``гггг-ММ-дд`
  • \<разделитель_сегментов\> - один из символов ` , T`
  • \<время\> имеет вид: ЧЧ:мм(:cc(.ССС)?)?
  • \<часовой_пояс\> - имя часового пояса или смещение в виде [+-]ЧЧ:мм
• Момент{} - значение по умолчанию 0001-01-01 00:00:00.000 Z
• Момент{Максимум} - максимальное значение 4000-01-01 17:59:59.999 Z
• Момент{Минимум} - минимальное значение 0000-12-31 06:00:00.000 Z

Арифметические операции

• Момент + Длительность = Момент (сложение)
• Момент - Длительность = Момент (вычитание)
• Момент - Момент = Длительность (вычитание)

Конструкторы

Момент

Момент(Представление: Строка)

Преобразует строковое представление Представление в соответствующий экземпляр момента.

Исключения

ИсключениеНедопустимыйФормат - если представление не является допустимым.

Момент

Момент(
  Дата: Дата,
  Время: Время,
  ЧасовойПояс: ЧасовойПояс)

Создает экземпляр момента соответствующий дате Дата и времени Время в часовом поясе ЧасовойПояс

Момент

Момент(
  Год: Число,
  Месяц: Число,
  День: Число,
  ЧасовойПояс: ЧасовойПояс)

Создает экземпляр момента соответствующий дате с компонентами Год, Месяц, День в часовом поясе ЧасовойПояс.

Момент

Момент(
  Год: Число,
  Месяц: Число,
  День: Число,
  Час: Число,
  Минута: Число,
  Секунда: Число,
  Миллисекунда: Число,
  ЧасовойПояс: ЧасовойПояс)

Создает экземпляр момента соответствующий дате с компонентами Год, Месяц, День и времени с компонентами Час, Минута, Секунда, Миллисекунда в часовом поясе ЧасовойПояс.

Методы

ВДатаВремя

ВДатаВремя(ЧасовойПояс: ЧасовойПояс): ДатаВремя

Преобразует данный экземпляр момента в датe-время в часовом поясе ЧасовойПояс. Если данный экземпляр является значением по умолчанию типа Момент (0001.01.01 00:00:00.000Z) будет возвращено значение по умолчанию для типа ДатаВремя (0001.01.01 00:00:00.000)

ВСтроку

ВСтроку(): Строка

Возвращает строковое представление момента в формате ISO-8601 ("гггг-ММ-дд'T'ЧЧ:мм:сс.ССС'Z'", где компоненты представлены в часовом поясе UTC). Пример: "2020-04-16T20:30:40.345Z".

ИзОтметкиВремениUnix

Статический ИзОтметкиВремениUnix(unixTimeStamp: Число): Момент

Создает момент времени, который соответствует заданному количеству секунд, прошедших с 1970-01-01 00:00:00 UTC.

Примеры

знч ОтметкаВремениUnix = 1675098000
знч МоментВремени = Момент.ИзОтметкиВремениUnix(ОтметкаВремениUnix) // 2023-01-30T17:00:00.000Z

ПолучитьОтметкуВремениUnix

ПолучитьОтметкуВремениUnix(): Число

Возвращает количество секунд прошедших с 1970-01-01 00:00:00 UTC.

Примеры

знч МоментВремени = Момент{2023-01-01 17:00:00 Z}
знч ОтметкаВремени = МоментВремени.ПолучитьОтметкуВремениUnix() // 1672592400

Представление

Представление(): Строка

Возвращает строковое представление момента, как даты времени в часовом поясе ЧасовойПояс.Текущий() в формате "дд.ММ.гггг ЧЧ:мм:сс". Пример: "16.04.2020 23:30:40".

Для значения по умолчанию 0001-01-01 00:00:00.000 Z возвращается пустая строка.

Сейчас

Статический Сейчас(): Момент

Возвращает текущий момент времени.

Список унаследованных методов

Объект

Сравнимое