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

Дата

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

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

Сейчас​

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

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

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

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

Объект​

ПолучитьТип

Сравнимое​

Сравнить

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