#日期格式化 (Форматування дати)

#1. :formatD(patternOut, patternIn)

#语法说明 (Опис синтаксису)

格式化日期，接受输出格式模式 patternOut，输入格式模式 patternIn（默认为 ISO 8601）。 Форматує дату, приймає шаблон вихідного формату patternOut та шаблон вхідного формату patternIn (за замовчуванням ISO 8601).

#常用示例 (Поширені приклади)

{d.createdAt:formatD(YYYY-MM-DD)}           // Виводить 2024-01-15
{d.createdAt:formatD(YYYY年M月D日)}          // Виводить 2024年1月15日
{d.updatedAt:formatD(YYYY年M月D日 HH:mm)}    // Виводить 2024年1月15日 14:30
{d.orderDate:formatD(YYYY/MM/DD HH:mm:ss)}  // Виводить 2024/01/15 14:30:25
{d.birthday:formatD(M月D日)}                 // Виводить 1月15日
{d.meetingTime:formatD(HH:mm)}              // Виводить 14:30
{d.deadline:formatD(YYYY年M月D日 dddd)}      // Виводить 2024年1月15日 星期一

#更多格式示例 (Більше прикладів форматів)

'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

#结果 (Результат)

输出为指定格式的日期字符串。 Виводиться рядок дати у вказаному форматі.

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

#语法说明 (Опис синтаксису)

在日期上添加指定的时间量。支持单位：day、week、month、quarter、year、hour、minute、second、millisecond。
Додає вказану кількість часу до дати. Підтримувані одиниці: day, week, month, quarter, year, hour, minute, second, millisecond.
参数 (Параметри):

• amount：添加的数量 (кількість для додавання)
• unit：时间单位（不区分大小写） (одиниця часу, без урахування регістру)
• patternIn：可选，输入格式，默认为 ISO8601 (необов'язково, вхідний формат, за замовчуванням ISO8601)

#示例 (Приклад)

'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。 Віднімає вказану кількість часу від дати. Параметри такі ж, як у addD.

#示例 (Приклад)

'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：可选，输入格式 (необов'язково, вхідний формат)

#示例 (Приклад)

'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)

#语法说明 (Опис синтаксису)

将日期设置为指定时间单位的结束时刻。
Встановлює дату на кінець вказаної одиниці часу.
参数同上 (Параметри такі ж, як вище).

#示例 (Приклад)

'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：输出日期格式 (вихідний формат дати)

#示例 (Приклад)

'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"

#结果 (Результат)

输出为转换后的日期字符串。 Виводиться рядок перетвореної дати.

#8. 日期格式模式 (Шаблони форматування дати)

常用日期格式说明（参照 DayJS 说明）： Опис поширених форматів дати (відповідно до документації DayJS):

• X：Unix 时间戳（秒），如 1360013296 (Unix-мітка часу у секундах)
• x：Unix 毫秒时间戳，如 1360013296123 (Unix-мітка часу у мілісекундах)
• YY：两位年份，如 18 (Двозначний рік)
• YYYY：四位年份，如 2018 (Чотиризначний рік)
• M、MM、MMM、MMMM：月份（数字、两位、缩写、全称） (Місяць: число, двозначне, скорочене, повна назва)
• D、DD：日（数字、两位） (День: число, двозначне)
• d、dd、ddd、dddd：星期（数字、最简、简写、全称） (День тижня: число, мінімальне, скорочене, повна назва)
• H、HH、h、hh：小时（24 小时制或 12 小时制） (Година: 24-годинний або 12-годинний формат)
• m、mm：分钟 (Хвилини)
• s、ss：秒 (Секунди)
• SSS：毫秒（3 位） (Мілісекунди: 3 цифри)
• Z、ZZ：UTC 偏移，如 +05:00 或 +0500 (Зміщення UTC)
• A、a：AM/PM
• Q：季度（1-4） (Квартал)
• Do：带序号的日期，如 1st, 2nd, … (День місяця з порядковим номером)
• 其它格式参见完整文档。 (Інші формати дивіться у повній документації.)
  此外，还有基于语言的本地化格式：如 LT、LTS、L、LL、LLL、LLLL 等。 (Крім того, існують локалізовані формати на основі мови: наприклад, LT, LTS, L, LL, LLL, LLLL тощо.)