форматДатыПоМаске
Функция форматДатыПоМаске выводит дату и время по заданной маске.
В отличие от функции форматДаты, здесь формат результата можно настроить самостоятельно.
Синтаксис
форматДатыПоМаске(дата, маска, [локаль])
Параметры:
дата— значение даты, времени или даты и времени, которое необходимо отформатировать;маска— готовый формат или маска, определяющая вид результата;локаль— язык названий месяцев и дней недели. Необязательный параметр. Если он не указан, используется локаль шаблона.
Для составления маски используются следующие обозначения:
| Обозначение | Значение | Пример |
|---|---|---|
dd |
день месяца | 05 |
ddd |
сокращённое название дня недели | сб |
dddd |
полное название дня недели | суббота |
MM |
месяц числом | 09 |
MMM |
сокращённое название месяца | сен |
MMMM |
полное название месяца | сентябрь |
yy |
год двумя цифрами | 26 |
yyyy |
год четырьмя цифрами | 2026 |
HH |
часы | 14 |
mm |
минуты | 30 |
ss |
секунды | 25 |
Обозначения можно комбинировать и разделять необходимыми символами.
Например:
"dd.MM.yyyy"
"yyyy-MM-dd"
"dd MMMM yyyy HH:mm"
Регистр символов имеет значение:
MM— месяц;mm— минуты.
Текст, который необходимо вывести без изменений, указывается в одинарных кавычках:
"dd.MM.yyyy 'в' HH:mm"
Возвращаемое значение
Функция возвращает текстовое значение, сформированное по указанной маске.
Например, если поле датаДоговора содержит:
05.09.2026
выражение:
форматДатыПоМаске(
датаДоговора,
"yyyy-MM-dd"
)
вернёт:
2026-09-05
Особенности
Локаль влияет на названия месяцев и дней недели.
Например, для маски:
"dd MMMM yyyy"
при русской локали результат может выглядеть так:
05 сентября 2026
при английской:
05 September 2026
Примеры
Дата и время
Если поле датаВремя содержит:
05.09.2026 14:30:25
выражение:
форматДатыПоМаске(
датаВремя,
"dd.MM.yyyy HH:mm:ss"
)
вернёт:
05.09.2026 14:30:25
Добавление текста
Выражение:
форматДатыПоМаске(
датаВремя,
"'Сформировано' dd.MM.yyyy 'в' HH:mm"
)
вернёт:
Сформировано 05.09.2026 в 14:30
День недели и дата
Выражение:
форматДатыПоМаске(
датаВремя,
"dddd, dd MMMM yyyy"
)
вернёт:
суббота, 05 сентября 2026
Связь с другими функциями
В параметр дата можно передавать результат функции, возвращающей дату или время.
Например:
форматДатыПоМаске(
дата(5, 9, 2026),
"dd MMMM yyyy"
)
вернёт:
05 сентября 2026