【JavaScript ECMAScript】Intl::Intl.DateTimeFormat() constructorコンストラクタの使い方

Intl.DateTimeFormat() constructorクラスは、国際化対応（Internationalization, i18n）のための日付と時刻の書式設定を可能にする DateTimeFormat オブジェクトを生成するクラスです。このコンストラクタを利用することで、アプリケーションが稼働するユーザーの言語や地域設定（ロケール）に合わせて、日付や時刻を自動的に整形し、表示することができます。例えば、日本であれば「2023/10/27」のように、アメリカであれば「10/27/2023」のように、各地域の慣習に沿った形式で出力されます。

このコンストラクタは、new Intl.DateTimeFormat([locales[, options]]) の形式で新しいインスタンスを作成します。locales 引数には、書式設定に使用する言語またはロケール（例: 'ja-JP', 'en-US') を文字列または文字列の配列で指定します。この引数を省略した場合、実行環境のデフォルトロケールが使用されます。options 引数には、年、月、日、曜日、時、分、秒、タイムゾーンなどの表示形式を細かく制御するためのプロパティを持つオブジェクトを指定します。これにより、年を4桁で表示するか、月を数値で表示するか文字で表示するかなど、詳細なカスタマイズが可能です。

生成された DateTimeFormat オブジェクトは、その format() メソッドなどを通じて、任意の日付オブジェクトを整形された文字列に変換する機能を提供します。システム開発において、世界中のユーザーが利用するアプリケーションで、それぞれのユーザーにとって自然な形式で日時を表示するために不可欠な機能であり、手動でロケールごとに日付フォーマットを実装する手間を省き、国際化対応の品質と開発効率を向上させます。

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

locales, options

• locales: string | string[] | undefined: フォーマットに使用するロケール（言語と地域）を指定します。配列で複数指定することも可能です。
• options: Intl.DateTimeFormatOptions | undefined: フォーマットの書式（年、月、日、時、分、秒などの表示方法）を詳細に指定するためのオブジェクトです。

戻り値なし

戻り値はありません