【JavaScript ECMAScript】Intl::Intl.DateTimeFormat.prototype.resolvedOptionsインスタンスメソッドの使い方

Intl.DateTimeFormat.prototype.resolvedOptions()メソッドは、Intl.DateTimeFormatオブジェクトが構築された際に、実際に適用されたロケールや書式設定オプションに関する情報を取得するメソッドです。

このメソッドを使用すると、Intl.DateTimeFormatコンストラクタに渡された初期オプションが、実行環境によってどのように解釈され、最終的にどのような値が採用されたのかを確認できます。たとえば、開発者が特定のロケール（言語と地域）や日付・時刻の書式オプションを指定したとしても、システムがその正確な設定をサポートしていない場合、より一般的な設定にフォールバックしたり、一部のオプションにデフォルト値が適用されたりすることがあります。

resolvedOptions()メソッドは、これらの「実際に解決された」または「最終的に決定された」設定を含む新しいオブジェクトを返します。このオブジェクトには、実際に使用されたロケールを表すlocaleプロパティをはじめ、日付の書式を制御するyear、month、day、時刻の書式を制御するhour、minute、second、さらにtimeZoneやcalendarといった、多岐にわたるプロパティが含まれます。

この情報は、特に国際化対応（i18n）を行う際に非常に役立ちます。開発者は、ユーザーの環境や指定に基づいて、日付や時刻が期待通りに表示されるかどうかを正確に検証し、デバッグすることが可能になります。これにより、アプリケーションが多様な地域や文化圏で一貫したユーザーエクスペリエンスを提供できるようになります。

Copy
1const dateTimeFormatter = new Intl.DateTimeFormat();
2const options = dateTimeFormatter.resolvedOptions();

引数なし

引数はありません

Object

このメソッドは、DateTimeFormatオブジェクトの作成時に設定されたオプションのうち、実際に有効となった設定値を表すオブジェクトを返します。