Дата

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

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

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

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

Литералы

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

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

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

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

Дата

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

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

Дата

Дата(
  Год: Число,
  Месяц: Число,
  День: Число)

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

Свойства

Год

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

День

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

Месяц

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

Методы

ВСтроку

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

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

ДеньГода

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

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

ДеньНедели

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

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

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

ДобавитьГоды(Годы: Число): Дата

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

ДобавитьДни

ДобавитьДни(Дни: Число): Дата

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

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

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

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

КонецГода

КонецГода(): Дата

Возвращает дату, соответствующую концу года, содержащего текущую дату.

КонецДня

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

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

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

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

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

КонецМесяца

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

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

НачалоГода

НачалоГода(): Дата

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

НачалоДня

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

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

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

НачалоКвартала(): Дата

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

СГодом

СГодом(Год: Число): Дата

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

СДнем

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

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

СДнемНедели

СДнемНедели(
  ДеньНедели: ДеньНедели,
  НачалоНедели: ДеньНедели? = Неопределено
): Дата

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

СМесяцем

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

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

Сейчас

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

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

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

Объект

Сравнимое