Intl.NumberFormat.prototype.resolvedOptions()

試してみましょう

const numberFormat = new Intl.NumberFormat("de-DE");
const options = numberFormat.resolvedOptions();

console.log(options.locale);
// 予想される結果 (Firefox / Safari): "de-DE"
// 予想される結果 (Chrome): "de"

console.log(options.numberingSystem);
// 予想される結果: "latn"

console.log(options.style);
// 予想される結果: "decimal"

構文

resolvedOptions()

引数

なし。

返値

この NumberFormat オブジェクトの初期化中に計算されたオプションを反映するプロパティを持つ新しいオブジェクト。このオブジェクトには、掲載る順に次のプロパティがあります。

locale

実際に使用されているロケールに対する BCP 47 言語タグは、ロケールネゴシエーションプロセスによって決定されます。リクエストされた場合、出力に入る可能性があるのは Unicode 拡張キーの nu のみです。

numberingSystem

options 引数で指定されたこのプロパティの値、または Unicode 拡張キー "nu" を使用して、必要に応じて既定値が設定されます。これは、このロケールに対応している記数法です。既定値はロケールによって異なります。

style

options 引数で指定されたこのプロパティの値で、必要に応じて既定値が入力されます。値は "decimal"、"percent"、"currency"、または"unit" のいずれかです。既定値は "decimal" です。

currency 省略可

options 引数でこのプロパティに指定された値。 style が "currency" の場合にのみ存在します。ISO 4217 通貨コードです。詳細については、Intl.supportedValuesOf() を参照してください。 style が "currency" の場合は必須であるため、既定値はありません。

currencyDisplay 省略可

options 引数でこのプロパティに指定された値で、必要に応じて既定値が入力されます。 style が "currency" の場合にのみ存在します。値は "code"、"symbol"、"narrowSymbol"、"name" のいずれかです。既定値は "symbol" です。

currencySign 省略可

options 引数でこのプロパティに指定された値で、必要に応じて既定値が設定されます。 style が "currency" の場合にのみ存在します。値は "standard" または"accounting" のどちらかです。既定値は "standard" です。

unit 省略可

options 引数で指定されたこのプロパティの値。 style が "unit" の場合にのみ存在します。これは認可された単位識別子で、完全な CLDR リストにあります。 style が "unit" の場合は必須であるため、既定値はありません。

unitDisplay 省略可

options 引数でこのプロパティに指定された値で、必要に応じて既定値が設定されます。 style が "unit" の場合にのみ存在します。値は "short"、"narrow"、"long" のいずれかです。既定値は "short" です。

minimumIntegerDigits

options 引数で指定されたこのプロパティの値で、必要に応じて既定値が設定されます。 1 から 21 までの整数です。既定値は 1 です。

minimumFractionDigits, maximumFractionDigits 省略可

options 引数でこれらのプロパティに指定された値で、必要に応じて既定値が設定されます。これらは必要な場合にのみ存在します。詳細については、桁オプションを参照してください。これは、0 から 100 までの整数です。

minimumSignificantDigits, maximumSignificantDigits 省略可

options 引数でこれらのプロパティに指定された値で、必要に応じて既定値が設定されます。これらは必要な場合にのみ存在します。詳細については、桁オプションを参照してください。これは、1 から 21 までの整数です。

useGrouping

options 引数で指定されたこのプロパティの値で、必要に応じて既定値が設定され、一部の値が正規化されています。値は、"always"、"auto"、"min2"、または論理値 false のいずれかです。 notation が "compact" の場合の既定値は "min2"、それ以外の場合は "auto" です。

notation

options 引数で指定されたこのプロパティの値で、必要に応じて既定値が設定されます。値は、"standard"、"scientific"、"engineering"、"compact" のいずれかです。既定値は "standard" です。

compactDisplay 省略可

options 引数でこのプロパティに指定された値で、必要に応じて既定値が設定されます。 notation が "compact" の場合にのみ存在します。値は "short" または"long" のどちらかです。既定値は "short" です。

signDisplay

options 引数で指定されたこのプロパティの値で、必要に応じて既定値が入力されます。値は、"auto"、"always"、"exceptZero"、"negative"、"never" のいずれかです。既定値は "auto" です。

roundingIncrement

options 引数で指定されたこのプロパティの値で、必要に応じて既定値が入力されます。値は、1、2、5、10、20、25、50、100、200、250、500、1000、2000、2500、5000 のいずれかです。既定値は 1 です。

roundingMode

options 引数で指定されたこのプロパティの値で、必要に応じて既定値が入力されます。値は、"ceil"、"floor"、"expand"、"trunc"、"halfCeil"、"halfFloor"、"halfExpand"、"halfTrunc"、"halfEven" のいずれかです。既定値は "halfExpand" です。

roundingPriority

options 引数で指定されたこのプロパティの値で、必要に応じて既定値が設定されます。値は "auto"、"morePrecision"、"lessPrecision" のいずれかです。既定値は "auto" です。

trailingZeroDisplay

options 引数でこのプロパティに指定された値で、必要に応じて既定値が設定されます。値は "auto" または "stripIfInteger" のどちらかです。既定値は "auto" です。

例

resolvedOptions メソッドの使用

// NumberFormat の作成
const de = new Intl.NumberFormat("de-DE", {
  style: "currency",
  currency: "USD",
  maximumFractionDigits: 2,
  roundingIncrement: 5,
  roundingMode: "halfCeil",
});

// options の解決
const usedOptions = de.resolvedOptions();
console.log(usedOptions.locale); // "de-DE"
console.log(usedOptions.numberingSystem); // "latn"
console.log(usedOptions.compactDisplay); // undefined （"notation" は "compact" に設定されていない）
console.log(usedOptions.currency); // "USD"
console.log(usedOptions.currencyDisplay); // "symbol"
console.log(usedOptions.currencySign); // "standard"
console.log(usedOptions.minimumIntegerDigits); // 1
console.log(usedOptions.minimumFractionDigits); // 2
console.log(usedOptions.maximumFractionDigits); // 2
console.log(usedOptions.minimumSignificantDigits); // undefined （maximumFractionDigits が設定されている）
console.log(usedOptions.maximumSignificantDigits); // undefined （maximumFractionDigits が設定されている）
console.log(usedOptions.notation); // "standard"
console.log(usedOptions.roundingIncrement); // 5
console.log(usedOptions.roundingMode); // halfCeil
console.log(usedOptions.roundingPriority); // auto
console.log(usedOptions.signDisplay); // "auto"
console.log(usedOptions.style); // "currency"
console.log(usedOptions.trailingZeroDisplay); // auto
console.log(usedOptions.useGrouping); // auto

仕様書

ブラウザーの互換性

関連情報

• Intl.NumberFormat