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

Intl.DurationFormat.prototype.resolvedOptions()メソッドは、Intl.DurationFormatオブジェクトが時間の長さを書式設定する際に、実際に使用しているロケールと書式設定オプションの最終的な値を取得するメソッドです。このメソッドを呼び出すと、新しいプレーンなJavaScriptオブジェクトが返され、そのオブジェクトには、Intl.DurationFormatコンストラクタで指定されたオプションが、デフォルト値やユーザーの環境設定によってどのように解決されたかが含まれています。

具体的には、返されるオブジェクトには、書式設定に適用されているロケール（例えば "en-US" や "ja-JP"）、時間の単位（年、月、日、時間、分、秒など）の表示スタイル（"long", "short", "narrow" など）、数値の表示方法といった、すべての解決済みの設定がプロパティとして含まれます。

このメソッドを利用することで、Intl.DurationFormatインスタンスが実際にどのような設定で動作しているかを確認できます。これは、国際化対応アプリケーションのデバッグや、異なるユーザー環境での表示の一貫性を保証するのに役立ちます。特に、コンストラクタで明示的に指定しなかったオプションや、ユーザーのシステム設定に依存するオプションがどのように解決されたかを正確に把握したい場合に非常に有用です。これにより、開発者は書式設定の挙動を詳細に理解し、予期せぬ表示の差異を防ぐことができます。

Copy
1const durationFormatInstance = new Intl.DurationFormat("en-US");
2const options = durationFormatInstance.resolvedOptions();

引数なし

引数はありません

Object

このメソッドは、Intl.DurationFormat オブジェクトの現在のローカライズ設定とオプションを含むオブジェクトを返します。