Intl.DateTimeFormat【国際化日時フォーマット】コンストラクタ・プロパティ・メソッド

new Intl.DateTimeFormat([locales [, options]])

戻り値Intl.DateTimeFormat【国際化日時フォーマット】 オブジェクト
localesBCP 47 の言語タグの文字列 または 配列 (省略：デフォルトのロケール) 詳細は下記参照
optionsオプション (実装依存) 詳細は下記参照

var date = new Date(Date.UTC(2001, (2 - 1), 3, 4, 5, 6));
var dtf = new Intl.DateTimeFormat();
console.log(dtf.format(date));
// 出力：2001/2/3

dtf = new Intl.DateTimeFormat("en-US");
console.log(dtf.format(date));
// 出力：2/3/2001

dtf = new Intl.DateTimeFormat("en-GB");
console.log(dtf.format(date));
// 出力：03/02/2001

var options = { year:'2-digit', month:'2-digit', day:'2-digit', hour12:true, hour:'2-digit', minute:'2-digit', second:'2-digit', weekday:'narrow', timeZone:'UTC', timeZoneName:'long' };
dtf = new Intl.DateTimeFormat("en-US", options);
console.log(dtf.format(date));
// 出力：S, 02/03/01, 4:05:06 AM GMT

options = { year:'numeric', month:'numeric', day:'numeric', hour12:false, hour:'2-digit', minute:'numeric', second:'numeric', weekday:'short', timeZone:'Asia/Tokyo', timeZoneName:'short' };
dtf = new Intl.DateTimeFormat("en-US", options);
console.log(dtf.format(date));
// 出力：Sat, 2/3/2001, 13:05:06 GMT+9

options = { year:'2-digit', month:'narrow', day:'2-digit', hour12:true, hour:'2-digit', minute:'2-digit', second:'2-digit', weekday:'long', timeZone:'Asia/Tokyo', timeZoneName:'long' };
dtf = new Intl.DateTimeFormat("en-US", options);
console.log(dtf.format(date));
// 出力：Saturday, F 03, 01, 1:05:06 PM Japan Standard Time

options = { year:'numeric', month:'short', day:'numeric', hour12:false, hour:'numeric', minute:'numeric', second:'numeric', weekday:'narrow', timeZone:'America/New_York', timeZoneName:'short' };
dtf = new Intl.DateTimeFormat("en-US", options);
console.log(dtf.format(date));
// 出力：F, Feb 2, 2001, 23:05:06 EST

options = { year:'2-digit', month:'long', day:'2-digit', hour12:true, hour:'numeric', minute:'2-digit', second:'2-digit', weekday:'short', timeZone:'America/New_York', timeZoneName:'long' };
dtf = new Intl.DateTimeFormat("en-US", options);
console.log(dtf.format(date));
// 出力：Fri, February 02, 01, 11:05:06 PM Eastern Standard Time

options = { era:'narrow', year:'numeric', month:'numeric', day:'numeric', hour:'numeric', minute:'numeric', second:'numeric', weekday:'narrow', hour12:true, timeZoneName:'long' };
dtf = new Intl.DateTimeFormat("ja-JP-u-ca-japanese", options);
console.log(dtf.format(date));
// 出力：H13年2月3日土 13時05分06秒 日本標準時

options = { era:'short', year:'2-digit', month:'2-digit', day:'2-digit',  hour:'2-digit', minute:'2-digit', second:'2-digit', weekday:'short', hour12:false, timeZoneName:'short' };
dtf = new Intl.DateTimeFormat("ja-JP-u-ca-japanese", options);
console.log(dtf.format(date));
// 出力：平成13年02月03日土 13:05:06 JST

options = { era:'long', year:'numeric', month:'numeric', day:'numeric', hour:'numeric', minute:'numeric', second:'numeric', weekday:'long', hour12:true, timeZoneName:'long' };
dtf = new Intl.DateTimeFormat("ja-JP-u-ca-japanese", options);
console.log(dtf.format(date));
// 出力：平成13年2月3日土曜日 13時05分06秒 日本標準時

options = { era:'long', year:'numeric', month:'long', day:'numeric', weekday:'long' };
dtf = new Intl.DateTimeFormat("ja-JP-u-ca-japanese-nu-hanidec", options);
console.log(dtf.format(date));
// 出力：平成一三年二月三日土曜日

dtf = new Intl.DateTimeFormat();
console.log(dtf.format());
// 出力：20xx/x/x 現在日付

format(date)

戻り値フォーマット文字列
date日時 (省略：現在日時)

// Array.map ()【配列変換生成】利用
var days = [ new Date(2001, (2 - 1), 3), new Date(2011, (3 - 1), 4), new Date(2021, (4 - 1), 5) ];
var dtf = new Intl.DateTimeFormat();
console.log(days.map(dtf.format)); // 出力：["2001/2/3", "2011/3/4", "2021/4/5"]

resolvedOptions()

戻り値オプション オブジェクト

var dtf = new Intl.DateTimeFormat();
console.log(dtf.resolvedOptions());
// 出力：
// object {
// calendar:"gregory"
// day:"numeric"
// locale:"ja"
// month:"numeric"
// numberingSystem:"latn"
// timeZone:"Asia/Tokyo"
// year:"numeric"
// }

console.log(dtf.format());
// 出力：20xx/xx/xx 現在日付

Intl.DateTimeFormat.supportedLocalesOf( locales [, options])

戻り値サポートされるロケールの配列
localesBCP 47 の言語タグの文字列 または 配列
new Intl.DateTimeFormat () 【コンストラクタ】のlocalesを参照
optionsオプション (localeMatcher【ロケールマッチングアルゴリズム】)
new Intl.DateTimeFormat () 【コンストラクタ】のoptionsを参照