format(dDate,sFormat,sLang)

Функция format предназначена для форматирования объекта даты в строку согласно переданному формату и языку.

PROPS:

1. dDate BmObject<Date> Объект даты
2. sFormat string Строка формата даты. Например, YYYY-MM-DD (см. Токены)
3. sLang?═"ru" string Язык, на котором нужно отформатировать дату:
   • "ru" Русский
   • "en" Английский
   • "uz" Узбекский
   • "kk" Казахский

RETURN:

• string Дата в соответствующем формате

EXAMPLES

api.utils.moment.format(new Date(), 'MMMM', curLng.short_id); // "Август"
api.utils.moment.format(new Date(), 'DD.MM.YYYY', 'ru'); //      "15.08.2024"
api.utils.moment.format(new Date(), 'DD MMMM YYYY'); //          "15 Августа 2024"
api.utils.moment.format(new Date(), 'ddd, DD MMMM'); //          "Чт, 15 Августа"
api.utils.moment.format(new Date(), 'YYYY [г.] DD MM'); //       "2024 г. 15 08"

---

Токены

Токен	Описание	Пример (английский / русский)
[Random Text]	Произвольный текст	Random Text

Форматирование года

Токен	Описание	Пример (английский / русский)
YYYY	Полный год	1970 1971 … 2029 2030
YY	Последние две цифры года	70 71 … 29 30

Форматирование квартала

Токен	Описание	Пример (английский / русский)
Qo	Квартал года с порядковым номером	1st 2nd 3rd 4th / 1-й 2-й 3-й 4-й
Q	Квартал года	1 2 3 4

Форматирование месяца

Токен	Описание	Пример (английский / русский)
MMMM	Полное название месяца	January February … November December August / Август (Августа)
MMM	Сокращённое название месяца	Jan Feb … Nov Dec
MM	Месяц с ведущим нулём	01 02 … 11 12
Mo	Месяц с порядковым номером	1st 2nd … 11th 12th1st 2nd … 11th 12th / 1-й 2-й … 11-й 12-й
M	Месяц без ведущего нуля	1 2 … 11 12

Форматирование недели

Токен	Описание	Пример (английский / русский)
wo	Неделя с порядковым номером	1st 2nd … 52nd 53rd / 1-я 2-я … 52-я 53-я
w	Неделя года	1 2 … 52 53
ww	Неделя года с ведущим нулём	01 02 … 52 53

Форматирование дня

Токен	Описание	Пример (английский / русский)
DDDD	День года с ведущим нулём	001 002 … 364 365
DDDo	День года с порядковым номером	1st 2nd … 364th 365th / 1-й 2-й … 364-й 365-й
DDD	День года	1 2 … 364 365
DD	День месяца с ведущим нулём	01 02 … 30 31
Do	День месяца с порядковым номером	1st 2nd … 30th 31st / 1-й 2-й … 30-й 31-й
D	День месяца без ведущего нуля	1 2 … 30 31
dddd	Полное название дня недели	Sunday Monday … Friday Saturday Thursday / Четверг
ddd	Сокращённое название дня недели	Sun Mon … Fri Sat Thu / Чт
dd	Краткое название дня недели	Su Mo … Fr Sa Th / Чт
do	День недели с порядковым номером	0th 1st … 5th 6th / 0-й 1-й … 5-й 6-й
d	День недели (0-Воскресенье)	0 1 … 5 6

Форматирование часов

Токен	Описание	Пример (английский / русский)
HH	Часы в 24-часовом формате с ведущим нулём	00 01 … 22 23
H	Часы в 24-часовом формате без нуля	0 1 … 22 23
kk	Часы в 24-часовом формате с ведущим нулём (24 вместо 0)	01 02 … 23 24
k	Часы в 24-часовом формате без нуля (24 вместо 0)	1 2 … 23 24
hh	Часы в 12-часовом формате с ведущим нулём	01 02 … 11 12
h	Часы в 12-часовом формате без нуля	1 2 … 11 12

Форматирование минут

Токен	Описание	Пример (английский / русский)
mm	Минуты с ведущим нулём	00 01 … 58 59
m	Минуты без ведущего нуля	0 1 … 58 59

Форматирование секунд

Токен	Описание	Пример (английский / русский)
ss	Секунды с ведущим нулём	00 01 … 58 59
s	Секунды без ведущего нуля	0 1 … 58 59

Форматирование периодов (AM/PM)

Токен	Описание	Пример (английский / русский)
A	AM/PM	AM PM / утра дня вечера ночи
a	am/pm	am pm / утра дня вечера ночи

Версии

v1.2.0

• Полная поддержка форматирования (любые токены, в любом количестве, в любом порядке, в любой комбинации)
• Добавлен токен [...] для произвольного текста
• Добавление токенов текстового форматирования DDDo, Do, do, Qo,Mo, wo, “

v1.1.0

• Исправление локализации
• Добавление токенов ww, w

v1.0.0

• Простейшие токены
• Поддержка 4 языков