Перейти к основному содержимому

ДатаВремя

Стд::Время::ДатаВремя

Локальная дата и время. Максимальное значение 9999-12-31 23:59:59.999. Минимальное значение 0001-01-01 00:00:00.000.

Сравнение

Структурное

Два экземпляра даты-времени равны, если равны их компоненты (дата, время).

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

Базовые типы: Объект, Объект, Представляемое, Сравнимое<ДатаВремя>, Форматируемое

Примеры​

Общие примеры

ДатаВремя{2021-07-19 13:45}

Литералы​

  • ДатаВремя{<дата><разделитель_сегментов><время>}
    • <дата> имеет вид: гггг-ММ-дд
    • <разделитель_сегментов> - один из символов , T
    • <время> имеет вид: ЧЧ:мм(:cc(.ССС)?)?
  • ДатаВремя{} - значение по умолчанию 0001-01-01 00:00:00.000
  • ДатаВремя{Максимум} - максимальное значение 9999-12-31 23:59:59.999
  • ДатаВремя{Минимум} - минимальное значение 0001-01-01 00:00:00.000

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

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

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

ДатаВремя​

ДатаВремя(Представление: Строка)
Преобразует строковое представление Представление в соответствующий экземпляр даты-времени.

Исключения​

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

Перегрузка
ДатаВремя(Год: Число, Месяц: Число, День: Число)
ДатаВремя(Год: Число, Месяц: Число, День: Число, Час: Число, Минута: Число, Секунда: Число, Миллисекунда: Число = 0)
ДатаВремя(Дата: Дата, Время: Время)

ДатаВремя​

ДатаВремя(
  Дата: Дата,
  Время: Время)
Создает дату-время на основе переданных компонентов Дата, Время.

Перегрузка
ДатаВремя(Представление: Строка)
ДатаВремя(Год: Число, Месяц: Число, День: Число)
ДатаВремя(Год: Число, Месяц: Число, День: Число, Час: Число, Минута: Число, Секунда: Число, Миллисекунда: Число = 0)

ДатаВремя​

ДатаВремя(
  Год: Число,
  Месяц: Число,
  День: Число)
Создает дату-время с нулевым временем на основе переданных компонентов Год, Месяц, День.

Перегрузка
ДатаВремя(Представление: Строка)
ДатаВремя(Год: Число, Месяц: Число, День: Число, Час: Число, Минута: Число, Секунда: Число, Миллисекунда: Число = 0)
ДатаВремя(Дата: Дата, Время: Время)

ДатаВремя​

ДатаВремя(
  Год: Число,
  Месяц: Число,
  День: Число,
  Час: Число,
  Минута: Число,
  Секунда: Число,
  Миллисекунда: Число = 0)
Создает дату-время на основе переданных компонентов Год, Месяц, День, Час, Минута, Секунда, Миллисекунда.

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

Свойства​

Время​

ТолькоЧтение

Время: Время

Значение времени.

Год​

ТолькоЧтение

Год: Число

Значение года.

Дата​

ТолькоЧтение

Дата: Дата

Значение Даты.

День​

ТолькоЧтение

День: Число

Значение дня.

Месяц​

ТолькоЧтение

Месяц: Число

Значение месяца.

Миллисекунда​

ТолькоЧтение

Миллисекунда: Число

Значение миллисекунд.

Минута​

ТолькоЧтение

Минута: Число

Значение минут.

Секунда​

ТолькоЧтение

Секунда: Число

Значение секунд.

Час​

ТолькоЧтение

Час: Число

Значение часа.

Методы​

ВМомент​

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

ВСтроку​

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

Переопределение
Объект::ВСтроку

ДеньГода​

ДеньГода(): Число
Возвращает порядковый номер дня в году, соответствующий данному экземпляру даты.

ДеньНедели​

ДеньНедели(): ДеньНедели
Возвращает день недели, соответствующий данному экземпляру даты.

ДобавитьГоды​

@ПроверятьИспользованиеЗначения
ДобавитьГоды(Годы: Число): ДатаВремя
Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество лет Годы к текущему значению. Если после преобразования день месяца не является валидным, то возвращается последний день месяца.

Примеры​

знч Результат = ДатаВремя{2024-02-29}.ДобавитьГоды(1) // ДатаВремя{2025-02-28}

ДобавитьДни​

@ПроверятьИспользованиеЗначения
ДобавитьДни(Дни: Число): ДатаВремя
Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество дней Дни к текущему значению.

ДобавитьМесяцы​

@ПроверятьИспользованиеЗначения
ДобавитьМесяцы(Месяцы: Число): ДатаВремя
Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество месяцев Месяцы к текущему значению. Если после преобразования день месяца не является валидным, то возвращается последний день месяца.

Примеры​

знч Результат = ДатаВремя{2023-01-31}.ДобавитьМесяцы(1) // ДатаВремя{2023-02-28}

ДобавитьМиллисекунды​

@ПроверятьИспользованиеЗначения
ДобавитьМиллисекунды(Миллисекунды: Число): ДатаВремя
Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество миллисекунд Миллисекунды к текущему значению.

ДобавитьМинуты​

@ПроверятьИспользованиеЗначения
ДобавитьМинуты(Минуты: Число): ДатаВремя
Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество минут Минуты к текущему значению.

ДобавитьСекунды​

@ПроверятьИспользованиеЗначения
ДобавитьСекунды(Секунды: Число): ДатаВремя
Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество секунд Секунды к текущему значению.

ДобавитьЧасы​

@ПроверятьИспользованиеЗначения
ДобавитьЧасы(Часы: Число): ДатаВремя
Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество часов Часы к текущему значению.

КонецГода​

КонецГода(): ДатаВремя
Возвращает значение даты-времени, соответствующее концу года, содержащего текущую дату-время.

КонецДекады​

КонецДекады(): ДатаВремя
Возвращает значение даты-времени, соответствующее концу декады, в которой присутствует текущая дата.

КонецДня​

КонецДня(): ДатаВремя
Возвращает значение даты-времени, соответствующее концу дня, содержащего текущую дату-время.

КонецКвартала​

КонецКвартала(): ДатаВремя
Возвращает значение даты-времени, соответствующее концу квартала, содержащего текущую дату-время.

КонецМесяца​

КонецМесяца(): ДатаВремя
Возвращает значение даты-времени, соответствующее концу месяца, содержащего текущую дату-время.

КонецМинуты​

КонецМинуты(): ДатаВремя
Возвращает значение даты-времени, соответствующее концу минуты, содержащей текущую дату-время.

КонецНедели​

КонецНедели(НачалоНедели: ДеньНедели? = Неопределено): ДатаВремя
Возвращает значение даты-времени, соответствующее концу недели, в которой присутствует текущая дата.

КонецПолугодия​

КонецПолугодия(): ДатаВремя
Возвращает дату, соответствующую концу полугодия, содержащего текущую дату.

КонецСекунды​

КонецСекунды(): ДатаВремя
Возвращает значение даты-времени, соответствующее концу секунды, содержащей текущую дату-время.

КонецЧаса​

КонецЧаса(): ДатаВремя
Возвращает значение даты-времени, соответствующее концу часа, содержащего текущую дату-время.

НачалоГода​

НачалоГода(): ДатаВремя
Возвращает значение даты-времени, соответствующее началу года, содержащего текущую дату-время.

НачалоДекады​

НачалоДекады(): ДатаВремя
Возвращает значение даты-времени, соответствующее началу декады, в которой присутствует текущая дата.

НачалоДня​

НачалоДня(): ДатаВремя
Возвращает значение даты-времени, соответствующее началу дня, содержащего текущую дату-время.

НачалоКвартала​

НачалоКвартала(): ДатаВремя
Возвращает значение даты-времени, соответствующее началу квартала, содержащего текущую дату-время.

НачалоМесяца​

НачалоМесяца(): ДатаВремя
Возвращает значение даты-времени, соответствующее началу месяца, содержащего текущую дату-время.

НачалоМинуты​

НачалоМинуты(): ДатаВремя
Возвращает значение даты-времени, соответствующее началу минуты, содержащей текущую дату-время.

НачалоНедели​

НачалоНедели(НачалоНедели: ДеньНедели? = Неопределено): ДатаВремя
Возвращает значение даты-времени, соответствующее началу недели, в которой присутствует текущая дата.

НачалоПолугодия​

НачалоПолугодия(): ДатаВремя
Возвращает дату, соответствующую началу полугодия, содержащего текущую дату.

НачалоСекунды​

НачалоСекунды(): ДатаВремя
Возвращает значение даты-времени, соответствующее началу секунды, содержащей текущую дату-время.

НачалоЧаса​

НачалоЧаса(): ДатаВремя
Возвращает значение даты-времени, соответствующее началу часа, содержащего текущую дату-время.

НомерКвартала​

НомерКвартала(): Число
Возвращает порядковый номер квартала в году, содержащего текущую дату.

НомерНедели​

НомерНедели(НачалоНедели: ДеньНедели? = Неопределено): Число
Возвращает порядковый номер недели в году, соответствующей данному экземпляру даты.

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

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

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

Переопределение
Объект::Представление

Перегрузка
Представление(Формат: Строка): Строка

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

Представление(Формат: Строка): Строка
Возвращает строковое представление даты-времени в указанном формате Формат. Форматная строка представляет собой строку из следующих элементов:

  • г - краткий номер года без лидирующего нуля;

  • гг - краткий номер года с лидирующим нулем;

  • гггг - полный номер года.

  • К - порядковый номер квартала в году;

  • М - месяц в диапазоне от 1 до 12;

  • ММ - месяц в диапазоне от 01 до 12 (с лидирующим нулем);

  • МММ - краткое название месяца; Если краткое название месяца используется после дня (д или дд), то месяц отображается в родительном падеже (если применимо). Если отдельно - в именительном (если применимо).

  • ММММ - полное название месяца; Если полное название месяца используется после дня (д или дд), то месяц отображается в родительном падеже (если применимо). Если отдельно - в именительном (если применимо).

  • д - день месяца (цифрами) без лидирующего нуля;

  • дд - день месяца (цифрами) с лидирующим нулем;

  • ддд - краткое название дня недели;

  • дддд - полное название дня недели;

  • Д - порядковый номер дня в году;

  • ч - час в 12-часовом варианте без лидирующих нулей;

  • чч - час в 12-часовом варианте с лидирующим нулем;

  • Ч - час в 24-часовом варианте без лидирующих нулей;

  • ЧЧ - час в 24-часовом варианте с лидирующим нулем;

  • м - минута без лидирующего нуля;

  • мм - минута с лидирующим нулем;

  • с - секунда без лидирующего нуля;

  • сс - секунда с лидирующим нулем;

  • С - миллисекунда с точностью до сотен;

  • СС - миллисекунда с точностью до десятков;

  • ССС - миллисекунда с точностью до единиц.

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

В любом месте форматной строки может быть сделана текстовая вставка. Она выделяется в одинарные кавычки ' с двух сторон. В случае необходимости использования одинарной кавычки в текстовой вставке - ее необходимо экранировать путем написания двух подряд идущих одинарных кавычек ''. Также в любом месте форматной строки может быть сделана вставка из небуквенных символов. Такая вставка никак не выделяется.

Названия дней недели, выводимых в Представление() при использовании соответствующих элементов:

День неделиПонедельникВторникСредаЧетвергПятницаСубботаВоскресенье
Полное названиепонедельниквторниксредачетвергпятницасубботавоскресенье
Сокращенное названиепнвтсрчтптсбвс

Названия месяцев, выводимых в Представление() при использовании соответствующих элементов:

МесяцЯнварьФевральМартАпрельМайИюньИюльАвгустСентябрьОктябрьНоябрьДекабрь
Название в именительном падежеянварьфевральмартапрельмайиюньиюльавгустсентябрьоктябрьноябрьдекабрь
Название в родительном падежеянваряфевралямартаапрелямаяиюняиюляавгустасентябряоктябряноябрядекабря
Сокращенное название в именительном падежеянвфеврмартапрмайиюньиюльавгсентоктноябдек
Сокращенное название в родительном падежеянвфеврмартаапрмаяиюняиюляавгсентоктноябдек

Переопределение
Форматируемое::Представление

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

СГодом​

@ПроверятьИспользованиеЗначения
СГодом(Год: Число): ДатаВремя
Возвращает новый экземпляр даты-времени с указанным значением года Год. Если после преобразования день месяца не является валидным, то возвращается последний день месяца.

Примеры​

знч Результат = ДатаВремя{2024-02-29}.СГодом(2023) // ДатаВремя{2023-02-28}

СДнем​

@ПроверятьИспользованиеЗначения
СДнем(День: Число): ДатаВремя
Возвращает новый экземпляр даты-времени с указанным значением дня День.

СДнемНедели​

@ПроверятьИспользованиеЗначения
СДнемНедели(
  ДеньНедели: ДеньНедели,
  НачалоНедели: ДеньНедели? = Неопределено
): ДатаВремя
Возвращает новый экземпляр даты-времени для указанного дня ДеньНедели на той же неделе. За первый день недели берется НачалоНедели, если Неопределено, то первым днем недели считается Понедельник.

СМесяцем​

@ПроверятьИспользованиеЗначения
СМесяцем(Месяц: Число): ДатаВремя
Возвращает новый экземпляр даты-времени с указанным значением месяца Месяц. Если после преобразования день месяца не является валидным, то возвращается последний день месяца.

Примеры​

знч Результат = ДатаВремя{2023-03-31}.СМесяцем(2) // ДатаВремя{2023-02-28}

СМиллисекундой​

@ПроверятьИспользованиеЗначения
СМиллисекундой(Миллисекунда: Число): ДатаВремя
Возвращает новый экземпляр даты-времени с указанным значением миллисекунд Миллисекунда.

СМинутой​

@ПроверятьИспользованиеЗначения
СМинутой(Минута: Число): ДатаВремя
Возвращает новый экземпляр даты-времени с указанным значением минут Минута.

ССекундой​

@ПроверятьИспользованиеЗначения
ССекундой(Секунда: Число): ДатаВремя
Возвращает новый экземпляр даты-времени с указанным значением секунд Секунда.

СЧасом​

@ПроверятьИспользованиеЗначения
СЧасом(Час: Число): ДатаВремя
Возвращает новый экземпляр даты-времени с указанным значением часа Час.

Сейчас​

Статический

Сейчас(ЧасовойПояс: ЧасовойПояс): ДатаВремя
Возвращает текущую дату-время в часовом поясе ЧасовойПояс.

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

Объект​

ВСтроку (Переопределение)

ПолучитьТип

Представляемое​

Представление (Переопределение)

Сравнимое​

Сравнить

Форматируемое​

Представление (Переопределение)

Последнее обновление