Link Search Menu Expand Document
1С:Предприятие.Элемент (5.2)

Дата

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

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

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

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

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

Литералы

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

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

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

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

Дата 

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

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

Исключения

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

Дата 

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

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

Свойства

Год

ТолькоЧтение Год: Число

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

День

ТолькоЧтение День: Число

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

Месяц

ТолькоЧтение Месяц: Число

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

Методы

ВСтроку 

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

Возвращает строковое представление даты в формате 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}

Сейчас 

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

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

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

Объект

ПолучитьТип

Сравнимое

Сравнить