Intl.DurationFormat.prototype.resolvedOptions()
Baseline
2025
Newly available
Since March 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
resolvedOptions() は Intl.DurationFormat インスタンスのメソッドで、現在の DurationFormat オブジェクトの初期化時に計算されたロケールとスタイルの書式オプションを反映したプロパティを持つ新しいオブジェクトを返します。
構文
resolvedOptions()
引数
なし。
返値
この DurationFormat オブジェクトの初期化時に計算されたオプションを反映したプロパティを持つ新しいオブジェクトです。このオブジェクトには、記載順に以下のプロパティがあります。
locale-
実際に使用されているロケールの BCP 47 言語タグです。これは、ロケールネゴシエーションのプロセスによって決定されます。出力には、Unicode の
nu拡張キーのみが含まれる可能性があります。 numberingSystem-
options引数で指定された値、または Unicode 拡張キー"nu"を使用して指定された値です。必要に応じてデフォルト値が設定されます。これは、このロケールで対応している記数法です。デフォルト値はロケールによって異なります。 style-
options引数でこのプロパティに指定された値です。必要に応じてデフォルト値が設定されます。値は"long"、"short"、"narrow"、"digital"のいずれかです。デフォルトは"short"です。 years,yearsDisplay,months,monthsDisplay,weeks,weeksDisplay,days,daysDisplay,hours,hoursDisplay,minutes,minutesDisplay,seconds,secondsDisplay,milliseconds,millisecondsDisplay,nanoseconds,nanosecondsDisplay-
options引数でこれらのプロパティに指定された値です。必要に応じてデフォルト値が設定されます。それぞれのプロパティの有効な値とデフォルト値については、コンストラクターのoptions引数を参照してください。 fractionalDigits省略可-
options引数でこのプロパティに指定された値です。optionsで指定されている場合にのみ存在します。0 以上 9 以下の整数です。
例
resolvedOptions メソッドの使用
const duration = new Intl.DurationFormat("en");
const usedOptions = duration.resolvedOptions();
usedOptions.locale; // "en"
usedOptions.numberingSystem; // "latn"
usedOptions.years; // "long"
usedOptions.yearsDisplay; // "auto"
usedOptions.style; // "long"
仕様書
| Specification |
|---|
| Intl.DurationFormat # sec-Intl.DurationFormat.prototype.resolvedOptions |