Повідомлення про переклад ШІ
Ця документація була автоматично перекладена штучним інтелектом.
Форматування дати
Опис синтаксису
Форматує дату, приймаючи шаблон вихідного формату 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) або dweek(s) або wquarter(s) або Qmonth(s) або Myear(s) або yhour(s) або hminute(s) або msecond(s) або smillisecond(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 (у секундах), наприклад, 1360013296x: Мітка часу Unix у мілісекундах, наприклад, 1360013296123YY: Двозначний рік, наприклад, 18YYYY: Чотиризначний рік, наприклад, 2018M, 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 або +0500A, a: AM/PMQ: Квартал (1-4)Do: День місяця з порядковим номером, наприклад, 1st, 2nd, …- Щодо інших форматів, зверніться до повної документації.
Крім того, існують локалізовані формати на основі мови, такі як
LT, LTS, L, LL, LLL, LLLL тощо.
