• 简体中文

      • 模板打印 - 日期格式化

      日期格式化

      1. :formatD(patternOut, patternIn)

      语法说明

      格式化日期，接受输出格式模式 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。
      参数：

      • amount：添加的数量
      • unit：时间单位（不区分大小写）
      • patternIn：可选，输入格式，默认为 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。

      示例
      '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 说明）：

      • 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 等。