このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Intl.DurationFormat.prototype.resolvedOptions()

Baseline 2025
最近利用可能

March 2025以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。

resolvedOptions()Intl.DurationFormat インスタンスのメソッドで、現在の DurationFormat オブジェクトの初期化時に計算されたロケールとスタイルの書式オプションを反映したプロパティを持つ新しいオブジェクトを返します。

構文

js
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 メソッドの使用

js
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"

仕様書

仕様書
Intl.DurationFormat
# sec-Intl.DurationFormat.prototype.resolvedOptions

ブラウザーの互換性

関連情報