форматДаты

Функция форматДаты изменяет формат отображения даты и времени.

Функция позволяет вывести дату или время целиком, получить отдельные части значения или представить дату прописью.

Синтаксис

форматДаты(дата, формат)

Параметры:

дата — значение даты, времени или даты и времени, которое необходимо отформатировать;
формат — формат отображения результата.

Для параметра формат доступны следующие значения:

Значение	Пример результата
`ФорматДаты.Время`	`13:22`
`ФорматДаты.ВремяПрописью`	`13 часов 22 минуты`
`ФорматДаты.ВремяССекундами`	`13:22:32`
`ФорматДаты.ВремяССекундамиПрописью`	`13 часов 22 минуты 32 секунды`
`ФорматДаты.Год`	`2023`
`ФорматДаты.ГодКратко`	`23`
`ФорматДаты.ГодСГод`	`2023 год`
`ФорматДаты.ДатаВремя`	`4 декабря 2023 13:22`
`ФорматДаты.ДатаВремяКратко`	`04.12.2023 13:25`
`ФорматДаты.ДатаВремяКраткоССекундами`	`04.12.2023 13:25:32`
`ФорматДаты.ДатаВремяССекундами`	`4 декабря 2023 13:22:32`
`ФорматДаты.ДатаКратко`	`04.12.2023`
`ФорматДаты.ДатаПолностьюГ`	`1 декабря 2023 г.`
`ФорматДаты.ДатаПолностьюГода`	`1 декабря 2023 года`
`ФорматДаты.ДатаПрописью`	`первое декабря две тысячи двадцать третий год`
`ФорматДаты.ДатаПрописьюГодРП`	`первое декабря две тысячи двадцать третьего года`
`ФорматДаты.ДатаПрописьюКратко`	`1 декабря 2023 (первое декабря две тысячи двадцать третий) год`
`ФорматДаты.ДатаПрописьюКраткоРП`	`1 декабря 2023 (первое декабря две тысячи двадцать третьего) год`
`ФорматДаты.ДатаПрописьюПолностью`	`01.12.2023 (первое декабря две тысячи двадцать третий) год`
`ФорматДаты.ДатаПрописьюПолностьюРП`	`01.12.2023 (первое декабря две тысячи двадцать третьего) год`
`ФорматДаты.ДатаПрописьюРП`	`первого декабря две тысячи двадцать третьего года`
`ФорматДаты.ДатаСКавычками`	`"01" декабря 2023 г.`
`ФорматДаты.ДатаСКавычкамиЕлочки`	`«01» декабря 2023 г.`
`ФорматДаты.День`	`01`
`ФорматДаты.День2ДатаПолностьюГ`	`01 декабря 2023 г.`
`ФорматДаты.День2ДатаПолностьюГода`	`01 декабря 2023 года`
`ФорматДаты.ДеньМесяц`	`01 декабря`
`ФорматДаты.ДеньНедели`	`Пятница`
`ФорматДаты.ДеньНеделиКратко`	`Пт`
`ФорматДаты.Месяц`	`декабрь`
`ФорматДаты.МесяцГод`	`декабрь 2023`
`ФорматДаты.МесяцКратко`	`дек`
`ФорматДаты.МесяцЧислом`	`12`
`ФорматДаты.Минуты`	`22`
`ФорматДаты.Секунды`	`32`
`ФорматДаты.Часы`	`13`

Возвращаемое значение

Функция возвращает текстовое значение в выбранном формате.

Например, если поле датаДоговора содержит дату:

01.12.2023

выражение:

форматДаты(
    датаДоговора,
    ФорматДаты.ДатаКратко
)

вернёт:

01.12.2023

Особенности

Выбранный формат определяет, какая часть исходного значения попадёт в результат.

Например, из значения типа «Дата/Время» можно получить только дату:

форматДаты(
    датаВремя,
    ФорматДаты.ДатаКратко
)

только время:

форматДаты(
    датаВремя,
    ФорматДаты.Время
)

или отдельную часть даты, например год:

форматДаты(
    датаВремя,
    ФорматДаты.Год
)

Если стандартных вариантов недостаточно, для формирования собственного представления даты и времени используйте функцию форматДатыПоМаске.

Примеры

Дата с кавычками

Выражение:

форматДаты(
    датаДоговора,
    ФорматДаты.ДатаСКавычкамиЕлочки
)

вернёт:

«01» декабря 2023 г.

Дата прописью

Выражение:

форматДаты(
    датаДоговора,
    ФорматДаты.ДатаПрописью
)

вернёт:

первое декабря две тысячи двадцать третий год

Получение дня недели

Если дата приходится на пятницу, выражение:

форматДаты(
    датаДоговора,
    ФорматДаты.ДеньНедели
)

вернёт:

Пятница

Связь с другими функциями

В параметр дата можно передавать результат другой функции, если она возвращает значение даты или времени.

Например, функцию форматДаты можно использовать вместе с функцией дата:

форматДаты(
    дата(1, 12, 2023),
    ФорматДаты.ДатаПолностьюГода
)

Результат:

1 декабря 2023 года

Сначала функция дата создаёт значение даты, после чего форматДаты возвращает его в выбранном формате.