Дата

Стд::Время::Дата
Базовые типы: Сравнимое,Форматируемое

Локальная дата.

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

Литералы

Дата{\<дата\>}
- \<дата\> имеет вид: гггг-ММ-дд
Дата{} - значение по умолчанию 0001-01-01

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

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

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

Дата

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

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

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

Дата

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

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

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

Свойства

Год

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

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

День

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

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

Месяц

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

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

Методы

ВСтроку

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

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

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

ДеньГода

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

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

ДеньНедели

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

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

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

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

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

ДобавитьДни

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

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

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

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

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

КонецГода

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

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

КонецДня

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

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

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

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

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

КонецМесяца

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

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

НачалоГода

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

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

НачалоДня

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для экранирования используется символ ' (одинарная кавычка).

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

СГодом

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

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

СДнем

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

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

СДнемНедели

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

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

СМесяцем

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

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

Сейчас

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

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