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

Дата

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

Локальная дата. Максимальное значение 9999-12-31. Минимальное значение 0001-01-01.

Сравнение

Структурное

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

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

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

Литералы​

  • Дата{<дата>}
    • <дата> имеет вид: гггг-ММ-дд
  • Дата{} - значение по умолчанию 0001-01-01
  • Дата{Максимум} - максимальное значение 9999-12-31
  • Дата{Минимум} - минимальное значение 0001-01-01

Примеры​

Дата{2021-07-19}

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

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

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

Дата​

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

Исключения​

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

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

Дата​

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

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

Свойства​

Год​

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

Год: Число

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

День​

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

День: Число

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

Месяц​

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

Месяц: Число

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

Методы​

ВСтроку​

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

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

ДеньГода​

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

ДеньНедели​

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

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

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

Примеры​

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

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

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

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

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

Примеры​

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

КонецГода​

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

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

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

КонецДня​

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

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

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

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

КонецМесяца(): Дата
Возвращает последний день месяца, в котором присутствует текущая дата.

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

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

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

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

НачалоГода​

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

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

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

НачалоДня​

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • г - краткий номер года без лидирующего нуля;
  • гг - краткий номер года с лидирующим нулем;
  • гггг - полный номер года.
  • К - порядковый номер квартала в году;
  • М - месяц в диапазоне от 1 до 12;
  • ММ - месяц в диапазоне от 01 до 12 (с лидирующим нулем);
  • МММ - краткое название месяца; Если краткое название месяца используется после дня (д или дд), то месяц отображается в родительном падеже (если применимо). Если отдельно - в именительном (если применимо).
  • ММММ - полное название месяца; Если полное название месяца используется после дня (д или дд), то месяц отображается в родительном падеже (если применимо). Если отдельно - в именительном (если применимо).
  • д - день месяца (цифрами) без лидирующего нуля;
  • дд - день месяца (цифрами) с лидирующим нулем;
  • ддд - краткое название дня недели;
  • дддд - полное название дня недели;
  • Д - порядковый номер дня в году;

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

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

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

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

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

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

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

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

СГодом​

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

Примеры​

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

СДнем​

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

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

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

СМесяцем​

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

Примеры​

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

Сейчас​

Статический

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

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

Объект​

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

ПолучитьТип

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

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

Сравнимое​

Сравнить

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

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

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