Link Search Menu Expand Document
1С:Исполнитель (5.0)

ДатаВремя

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

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

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

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

СДнем 

СДнем(День: Число): ДатаВремя
Аннотации: ПроверятьИспользованиеЗначения

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

СДнемНедели 

СДнемНедели(
  ДеньНедели: ДеньНедели,
  НачалоНедели: ДеньНедели? = Неопределено
): ДатаВремя
Аннотации: ПроверятьИспользованиеЗначения

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

СМесяцем 

СМесяцем(Месяц: Число): ДатаВремя
Аннотации: ПроверятьИспользованиеЗначения

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

Примеры 

ДатаВремя{2023-03-31}.СМесяцем(2) // ДатаВремя{2023-02-28}

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

СМиллисекундой(Миллисекунда: Число): ДатаВремя
Аннотации: ПроверятьИспользованиеЗначения

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

СМинутой 

СМинутой(Минута: Число): ДатаВремя
Аннотации: ПроверятьИспользованиеЗначения

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

ССекундой 

ССекундой(Секунда: Число): ДатаВремя
Аннотации: ПроверятьИспользованиеЗначения

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

СЧасом 

СЧасом(Час: Число): ДатаВремя
Аннотации: ПроверятьИспользованиеЗначения

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

Сейчас 

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

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

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

Объект

ПолучитьТип

Сравнимое

Сравнить