• 日本語

      • 日付フォーマット

      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)

      文法説明

      2つの日付の差分を計算し、指定された単位で出力します。サポートされている出力単位：

      • 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
      結果

      2つの日付間の時間差を出力します。単位は指定に従って変換されます。

      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：2桁の年、例：18
      • YYYY：4桁の年、例：2018
      • M、MM、MMM、MMMM：月（数字、2桁、略称、フルネーム）
      • D、DD：日（数字、2桁）
      • 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 など。