ДатаВремя

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

graph TD;
ДатаВремя-->Сравнимое;
Сравнимое-->Объект;
ДатаВремя-->Форматируемое;
Представляемое-->Объект;
Форматируемое-->Представляемое;

Локальная дата и время. Максимальное значение 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)

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

Свойства

Время

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

Год

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

Дата

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

День

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

Месяц

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

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

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

Минута

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

Секунда

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

Час

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

Методы

ВМомент

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

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

ВСтроку

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

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

ДеньГода

ДеньГода(): Число

Возвращает порядковый номер дня в году, соответствующий данному экземпляру даты.

ДеньНедели

ДеньНедели(): ДеньНедели

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

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

ДобавитьГоды(Годы: Число): ДатаВремя

Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество лет Годы к текущему значению.

ДобавитьДни

ДобавитьДни(Дни: Число): ДатаВремя

Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество дней Дни к текущему значению.

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

ДобавитьМесяцы(Месяцы: Число): ДатаВремя

Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество месяцев Месяцы к текущему значению.

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

ДобавитьМиллисекунды(Миллисекунды: Число): ДатаВремя

Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество миллисекунд Миллисекунды к текущему значению.

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

ДобавитьМинуты(Минуты: Число): ДатаВремя

Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество минут Минуты к текущему значению.

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

ДобавитьСекунды(Секунды: Число): ДатаВремя

Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество секунд Секунды к текущему значению.

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

ДобавитьЧасы(Часы: Число): ДатаВремя

Возвращает новый экземпляр даты-времени, полученный путем добавления указанного количество часов Часы к текущему значению.

КонецГода

КонецГода(): ДатаВремя

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

КонецДня

КонецДня(): ДатаВремя

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

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

КонецКвартала(): ДатаВремя

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

КонецМесяца

КонецМесяца(): ДатаВремя

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

КонецМинуты

КонецМинуты(): ДатаВремя

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

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

КонецСекунды(): ДатаВремя

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

КонецЧаса

КонецЧаса(): ДатаВремя

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

НачалоГода

НачалоГода(): ДатаВремя

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

НачалоДня

НачалоДня(): ДатаВремя

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

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

НачалоКвартала(): ДатаВремя

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

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

НачалоМесяца(): ДатаВремя

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

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

НачалоМинуты(): ДатаВремя

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

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

НачалоСекунды(): ДатаВремя

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

НачалоЧаса

НачалоЧаса(): ДатаВремя

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

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

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

Возвращает строковое представление даты-времени в формате "дд.ММ.гггг ЧЧ:мм:сс". Пример: "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 возвращается пустая строка.

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

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

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

СГодом

СГодом(Год: Число): ДатаВремя

Возвращает новый экземпляр даты-времени с указанным значением года Год.

СДнем

СДнем(День: Число): ДатаВремя

Возвращает новый экземпляр даты-времени с указанным значением дня День.

СДнемНедели

СДнемНедели(
  ДеньНедели: ДеньНедели,
  НачалоНедели: ДеньНедели
): ДатаВремя

Возвращает новый экземпляр даты-времени для указанного дня ДеньНедели на той же неделе. За первый день недели берется НачалоНедели, если Undefined, то первым днем недели считается Понедельник.

СМесяцем

СМесяцем(Месяц: Число): ДатаВремя

Возвращает новый экземпляр даты-времени с указанным значением месяца Месяц.

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

СМиллисекундой(Миллисекунда: Число): ДатаВремя

Возвращает новый экземпляр даты-времени с указанным значением миллисекунд Миллисекунда.

СМинутой

СМинутой(Минута: Число): ДатаВремя

Возвращает новый экземпляр даты-времени с указанным значением минут Минута.

ССекундой

ССекундой(Секунда: Число): ДатаВремя

Возвращает новый экземпляр даты-времени с указанным значением секунд Секунда.

СЧасом

СЧасом(Час: Число): ДатаВремя

Возвращает новый экземпляр даты-времени с указанным значением часа Час.

Сейчас

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

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

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

Объект

Сравнимое