Intl.DateTimeFormat - 日付表記の変換

Intl.DateTimeFormatの例

const dateObj = new Date(2012, 2, 4, 5, 6, 7, 8);
Intl.DateTimeFormat('ja', { dateStyle: 'full', timeStyle: 'full' }).format(dateObj);

第1引数(locales引数)

jaやen-USなど言語コードを指定します。

詳しくはJavaScriptにおける言語コード指定の詳解をご覧下さい。

第2引数(options引数)

言語以外のオプションをオブジェクト形式で指定します。

{
    dateStyle: 'full',
    timeStyle: 'full'
} // 例

以下では、言語コードがjaとen-USの場合についての出力を載せます。

numberingSystem

番号表記法を指定します。言語コード指定でのu-nu-何かと同じですが、それよりもこのプロパティ値が優先されます。

calendar

紀年法を指定します。言語コード指定でのu-ca-何かと同じですが、それよりもこのプロパティ値が優先されます。

localeMatcher

第1引数で指定した言語コードと、実装が対応している言語コードリストとのマッチングアルゴリズムを指定します。初期値はbest fitです。

dateStyle

年月日、指定によっては曜日も出力します。

timeStyle

時分、指定によっては秒とタイムゾーン名も出力します。

dayPeriod

各言語での表現に合わせて時の表現をするのですが、動作しませんでした。 動作するようになれば、おそらくhttps://github.com/tc39/ecma402/pull/346のような出力になるでしょう。

timeZone

指定されたタイムゾーンでの時刻を出力します。指定できる値は3文字のタイムゾーンIDまたはIANA指定のタイムゾーンIDです。規定値は、そのOSまたはブラウザが設定しているタイムゾーンに基づきます。

const dateObj = new Date(2012, 2, 4, 5, 6, 7, 8);
const options = { hour: 'numeric', minute: 'numeric', timeZone: 'Egypt', timeZoneName: 'long' };
new Intl.DateTimeFormat('ja', options).format(dateObj);
// 出力 '4:06 中国標準時'

hour12

午前・午後の概念がある12時制にするかを指定します。

規定では言語によって異なるため、それでは扱いにくいという場合には使うのもありでしょう。第一引数で指定する言語コードのサブタグ(u-hc-何か)やhourCycleプロパティよりも優先されます。

hourCycle

hour12プロパティに似ていて、時制の指定です。指定値は言語コード指定でのu-hc-何かと同じで、以下の通りです。

第一引数で指定する言語コードのサブタグ(u-hc-何か)よりも優先されます。

formatMatcher

weekday, year, month, day, hour, minute, secondプロパティの扱い方に関わるアルゴリズムです。このプロパティを指定しなかった場合の規定値はbest fitです。

best fitのアルゴリズムは実装依存なので、出力の統一性に不安がある場合はbasic指定も良いでしょう。

era

紀年を出力します。

calendarプロパティや言語コードのu-ca-何かを使うと、西暦ではない別の紀年法で出力されます。

year

年を出力します。

month

月を出力します。

day

日を出力します。

weekday

曜日を出力します。

narrowを指定した場合の英語出力は、火曜日も木曜日もTになってしまいますので、曜日で区別したい場面では他の指定値を使いましょう。

hour

時を出力します。

minute

分を出力します。

second

秒を出力します。

fractionalSecondDigits

ミリ秒を指定した桁数(1~3)で出力します。指定値の小数点以下は切り捨てされます。 2020年10月22日現在、FirefoxやMac Safariでは無視され、Chromeでも1未満4以上で指定するとエラーになってしまいます。

これと併せてminuteプロパティを指定すると、secondプロパティを指定しなくても秒が出力されます。

const dateObj = new Date(2012, 2, 4, 5, 6, 7, 8);
Intl.DateTimeFormat('ja', { minute: 'numeric', fractionalSecondDigits: 3 }).format(dateObj);
// 出力：'06:07.008'

timeZoneName

タイムゾーン情報を出力します。

時分秒はセットで

実用的には、オプションで時と分と秒を併せて指定するのが良いでしょう。

hour + minute

options = { hour: string, minute: string }; // 時と分

hour + minute + second

options = { hour: string, minute: string, second: string }; // 時分秒

参考リンク

• Intl - JavaScript | MDN
• Intl.DateTimeFormat() コンストラクター - JavaScript | MDN
• 言語タグ - HTML5