#Форматирование даты

#1. :formatD(patternOut, patternIn)

#Описание синтаксиса

Форматирует дату, принимая шаблон выходного формата patternOut и необязательный шаблон входного формата patternIn (по умолчанию используется ISO 8601). Вы можете настроить часовой пояс и язык с помощью опций options.timezone и options.lang.

#Пример

// Пример окружения: опции API { "lang": "en-us", "timezone": "Europe/Paris" }
'20160131':formatD(L)      // Выведет 01/31/2016
'20160131':formatD(LL)     // Выведет January 31, 2016
'20160131':formatD(LLLL)   // Выведет Sunday, January 31, 2016 12:00 AM
'20160131':formatD(dddd)   // Выведет Sunday

// Пример на французском:
'2017-05-10T15:57:23.769561+03:00':formatD(LLLL)  // Выведет mercredi 10 mai 2017 14:57
'20160131':formatD(LLLL)   // Выведет dimanche 31 janvier 2016 00:00
1410715640:formatD(LLLL, X) // Выведет dimanche 14 septembre 2014 19:27

#Результат

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

#2. :addD(amount, unit, patternIn)

#Описание синтаксиса

Добавляет указанное количество времени к дате. Поддерживаются следующие единицы измерения: day (день), week (неделя), month (месяц), quarter (квартал), year (год), hour (час), minute (минута), second (секунда), millisecond (миллисекунда).

Параметры:

• amount: Количество для добавления.
• unit: Единица измерения времени (регистронезависимая).
• patternIn: Необязательный параметр, входной формат (по умолчанию ISO8601).

#Пример

// Пример окружения: опции API { "lang": "fr", "timezone": "Europe/Paris" }
'2017-05-10T15:57:23.769561+03:00':addD('3', 'day')    // Выведет "2017-05-13T12:57:23.769Z"
'2017-05-10 15:57:23.769561+03:00':addD('3', 'month')      // Выведет "2017-08-10T12:57:23.769Z"
'20160131':addD('3', 'day')       // Выведет "2016-02-03T00:00:00.000Z"
'20160131':addD('3', 'month')     // Выведет "2016-04-30T00:00:00.000Z"
'31-2016-01':addD('3', 'month', 'DD-YYYY-MM')  // Выведет "2016-04-30T00:00:00.000Z"

#Результат

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

#3. :subD(amount, unit, patternIn)

#Описание синтаксиса

Вычитает указанное количество времени из даты. Параметры такие же, как и для функции addD.

#Пример

// Пример окружения: опции API { "lang": "fr", "timezone": "Europe/Paris" }
'2017-05-10T15:57:23.769561+03:00':subD('3', 'day')    // Выведет "2017-05-07T12:57:23.769Z"
'2017-05-10 15:57:23.769561+03:00':subD('3', 'month')      // Выведет "2017-02-10T12:57:23.769Z"
'20160131':subD('3', 'day')       // Выведет "2016-01-28T00:00:00.000Z"
'20160131':subD('3', 'month')     // Выведет "2015-10-31T00:00:00.000Z"
'31-2016-01':subD('3', 'month', 'DD-YYYY-MM')  // Выведет "2015-10-31T00:00:00.000Z"

#Результат

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

#4. :startOfD(unit, patternIn)

#Описание синтаксиса

Устанавливает дату на начало указанной единицы измерения времени.

Параметры:

• unit: Единица измерения времени.
• patternIn: Необязательный параметр, входной формат.

#Пример

// Пример окружения: опции API { "lang": "fr", "timezone": "Europe/Paris" }
'2017-05-10T15:57:23.769561+03:00':startOfD('day')    // Выведет "2017-05-10T00:00:00.000Z"
'2017-05-10 15:57:23.769561+03:00':startOfD('month')      // Выведет "2017-05-01T00:00:00.000Z"
'20160131':startOfD('day')       // Выведет "2016-01-31T00:00:00.000Z"
'20160131':startOfD('month')     // Выведет "2016-01-01T00:00:00.000Z"
'31-2016-01':startOfD('month', 'DD-YYYY-MM')  // Выведет "2016-01-01T00:00:00.000Z"

#Результат

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

#5. :endOfD(unit, patternIn)

#Описание синтаксиса

Устанавливает дату на конец указанной единицы измерения времени. Параметры такие же, как и для функции startOfD.

#Пример

// Пример окружения: опции API { "lang": "fr", "timezone": "Europe/Paris" }
'2017-05-10T15:57:23.769561+03:00':endOfD('day')    // Выведет "2017-05-10T23:59:59.999Z"
'2017-05-10 15:57:23.769561+03:00':endOfD('month')      // Выведет "2017-05-31T23:59:59.999Z"
'20160131':endOfD('day')       // Выведет "2016-01-31T23:59:59.999Z"
'20160131':endOfD('month')     // Выведет "2016-01-31T23:59:59.999Z"
'31-2016-01':endOfD('month', 'DD-YYYY-MM')  // Выведет "2016-01-31T23:59:59.999Z"

#Результат

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

#6. :diffD(toDate, unit, patternFromDate, patternToDate)

#Описание синтаксиса

Вычисляет разницу между двумя датами и выводит ее в указанных единицах измерения. Поддерживаются следующие единицы измерения:

• day(s) или d (день/дни)
• week(s) или w (неделя/недели)
• quarter(s) или Q (квартал/кварталы)
• month(s) или M (месяц/месяцы)
• year(s) или y (год/годы)
• hour(s) или h (час/часы)
• minute(s) или m (минута/минуты)
• second(s) или s (секунда/секунды)
• millisecond(s) или ms (миллисекунда/миллисекунды) (единица по умолчанию)

Параметры:

• toDate: Целевая дата.
• unit: Единица измерения для вывода.
• patternFromDate: Необязательный параметр, формат начальной даты.
• patternToDate: Необязательный параметр, формат целевой даты.

#Пример

'20101001':diffD('20101201')              // Выведет 5270400000
'20101001':diffD('20101201', 'second')      // Выведет 5270400
'20101001':diffD('20101201', 's')           // Выведет 5270400
'20101001':diffD('20101201', 'm')           // Выведет 87840
'20101001':diffD('20101201', 'h')           // Выведет 1464
'20101001':diffD('20101201', 'weeks')       // Выведет 8
'20101001':diffD('20101201', 'days')        // Выведет 61
'2010+10+01':diffD('2010=12=01', 'ms', 'YYYY+MM+DD', 'YYYY=MM=DD')  // Выведет 5270400000

#Результат

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

#7. :convDate(patternIn, patternOut)

#Описание синтаксиса

Преобразует дату из одного формата в другой (использование не рекомендуется).

Параметры:

• patternIn: Входной формат даты.
• patternOut: Выходной формат даты.

#Пример

// Пример окружения: опции API { "lang": "en", "timezone": "Europe/Paris" }
'20160131':convDate('YYYYMMDD', 'L')      // Выведет "01/31/2016"
'20160131':convDate('YYYYMMDD', 'LL')     // Выведет "January 31, 2016"
'20160131':convDate('YYYYMMDD', 'LLLL')   // Выведет "Sunday, January 31, 2016 12:00 AM"
'20160131':convDate('YYYYMMDD', 'dddd')   // Выведет "Sunday"
1410715640:convDate('X', 'LLLL')          // Выведет "Sunday, September 14, 2014 7:27 PM"
// Пример на французском:
'20160131':convDate('YYYYMMDD', 'LLLL')   // Выведет "dimanche 31 janvier 2016 00:00"
'20160131':convDate('YYYYMMDD', 'dddd')   // Выведет "dimanche"

#Результат

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

#8. Шаблоны форматирования даты

Общепринятые символы форматирования даты (см. документацию DayJS):

• X: Unix-метка времени (в секундах), например, 1360013296
• x: Unix-метка времени в миллисекундах, например, 1360013296123
• YY: Двузначный год, например, 18
• YYYY: Четырехзначный год, например, 2018
• M, MM, MMM, MMMM: Месяц (цифровой, двузначный, сокращенный, полное название)
• D, DD: День (цифровой, двузначный)
• d, dd, ddd, dddd: День недели (цифровой, минимальный, сокращенный, полное название)
• H, HH, h, hh: Час (24-часовой или 12-часовой формат)
• m, mm: Минута
• s, ss: Секунда
• SSS: Миллисекунды (3 цифры)
• Z, ZZ: Смещение UTC, например, +05:00 или +0500
• A, a: AM/PM
• Q: Квартал (1-4)
• Do: День месяца с порядковым номером, например, 1st, 2nd, …
• Другие форматы см. в полной документации. Кроме того, существуют локализованные форматы, зависящие от языка, такие как LT, LTS, L, LL, LLL, LLLL и т.д.