TIP
このドキュメントはAIによって翻訳されました。不正確な情報については、英語版をご参照ください
日付のフォーマット
構文の説明
日付をフォーマットします。出力フォーマットのパターン 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)
構文の説明
日付を指定した時間単位の終了時刻に設定します。
パラメーターは上記と同じです。
例
// 例の環境: 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)
構文の説明
2つの日付間の差を計算し、指定された単位で出力します。サポートされている出力単位は次のとおりです:
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
結果
2つの日付間の時間差が、指定された単位に変換されて出力されます。
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: 2桁の年。例: 18YYYY: 4桁の年。例: 2018M、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 または +0500A、a: 午前/午後Q: 四半期 (1-4)Do: 序数付きの日付。例: 1st, 2nd, …- その他のフォーマットについては、完全なドキュメントを参照してください。
さらに、LT、LTS、L、LL、LLL、LLLL など、言語に基づいたローカライズされたフォーマットもあります。
