Intl.NumberFormat.prototype.resolvedOptions()

基线广泛可用

此功能已得到良好建立，并且可在许多设备和浏览器版本上运行。它自以下版本起在浏览器中可用 2017 年 9 月.

的resolvedOptions()方法Intl.NumberFormat实例返回一个新对象，其属性反映了在初始化此Intl.NumberFormat对象期间计算的区域设置和数字格式选项。

试一试

语法

resolvedOptions()

参数

无。

返回值

一个新对象，其属性反映了在构造给定 Intl.NumberFormat对象期间计算的区域设置和数字格式选项。

结果对象具有以下属性

compactDisplay: 使用紧凑表示法时是否使用短格式或长格式。这是在构造函数的options.compactDisplay参数中提供的值，或默认值："short"。仅当notation设置为“compact”时，该值才会存在，否则为undefined。
currency: 在货币格式化中使用的货币。如果style为"currency"，则定义该值，否则为undefined。这是在构造函数的options.currency参数中提供的值。
currencyDisplay: 货币的显示格式，例如符号或货币代码。如果style为"currency"，则定义该值，否则为undefined。这是在构造函数的options.currencyDisplay参数中提供的值，或默认值："symbol"。
currencySign: 用于指定货币值符号的方法：standard或accounting。如果style为"currency"，则存在该值，否则为undefined。这是在构造函数的options.currencySign参数中提供的值，或默认值："standard"。
locale: 实际使用的区域设置的 BCP 47 语言标记。与在构造函数locales中请求的区域设置之一匹配。
notation: 应应用于数字的格式，例如standard或engineering。这是在构造函数的options.notation参数中提供的值，或默认值："standard"。
numberingSystem: 数字系统。这是在构造函数的options.numberingSystem参数中提供的值（如果存在），或使用 Unicode 扩展键nu设置的值，或作为默认值填充。
roundingIncrement: 舍入增量精度（舍入数字时使用的增量）。这是在构造函数的options.roundingIncrement参数中指定的值。
roundingMode: 舍入模式。这是在构造函数的options.roundingMode参数中提供的值，或默认值：halfExpand。
roundingPriority: 如果同时指定了“FractionDigits”和“SignificantDigits”，则解决舍入冲突的优先级。这是在构造函数的options.roundingPriority参数中提供的值，或默认值：auto。
signDisplay: 是否显示正/负号。这是在构造函数的options.signDisplay参数中指定的值，或默认值："auto"。
unit: 在单位格式化中使用的单位。仅当style为"unit"时，该值才会存在，否则为undefined。这是在构造函数的options.unit参数中指定的值。
unitDisplay: 在单位格式化中用于单位的显示格式，例如“long”、“short”或“narrow”。仅当style为"unit"时，该值才会存在，否则为undefined。这是在构造函数的options.unitDisplay参数中指定的值，或默认值：short。
useGrouping: 是否使用分组分隔符来指示“千位”、“百万位”等。这是在构造函数的options.useGrouping参数中指定的值，或默认值："auto"。
trailingZeroDisplay: 显示整数后面零的策略。这是在构造函数的options.trailingZeroDisplay参数中指定的值，或默认值："auto"。

仅包含以下两个属性组中的一个

minimumIntegerDigits、minimumFractionDigits、maximumFractionDigits: 在options参数中提供的值或作为默认值填充。仅当options参数中既未提供minimumSignificantDigits也未提供maximumSignificantDigits时，这些属性才会存在。
minimumSignificantDigits、maximumSignificantDigits: 在options参数中提供的值或作为默认值填充。仅当options参数中至少提供了一个值时，这些属性才会存在。

示例

使用`resolvedOptions`方法

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

// Resolve the options
const usedOptions = de.resolvedOptions();
console.log(usedOptions.locale); // "de-DE"
console.log(usedOptions.numberingSystem); // "latn"
console.log(usedOptions.compactDisplay); // undefined ("notation" not set to "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 is set)
console.log(usedOptions.maximumSignificantDigits); // undefined (maximumFractionDigits is set)
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

规范

规范
ECMAScript 国际化 API 规范 # sec-intl.numberformat.prototype.resolvedoptions

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅

Intl.NumberFormat