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

ДатаВремя

Стд::Время::ДатаВремя Доступность: КлиентИСервер

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

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

Доступность: КлиентИСервер

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

СМинутой​

Доступность: КлиентИСервер

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

ССекундой​

Доступность: КлиентИСервер

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

СЧасом​

Доступность: КлиентИСервер

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

Сейчас​

Доступность: КлиентИСервер Статический

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

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

Объект​

ПолучитьТип

Сравнимое​

Сравнить

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