Intl.PluralRules.prototype.resolvedOptions()

基线 广泛可用

此功能已得到很好的确立,并且可以在许多设备和浏览器版本上运行。它已在浏览器中可用,自 2019 年 9 月.

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

试一试

语法

js
resolvedOptions()

参数

无。

返回值

一个新对象,其属性反映了在给定 Intl.PluralRules 对象初始化期间计算出的区域设置和复数格式选项。

该对象具有以下属性

locale

实际使用的区域设置的 BCP 47 语言标签。如果在导致此区域设置的输入 BCP 47 语言标签中请求了任何 Unicode 扩展值,则在 locale 中包含请求的并在此区域设置中受支持的键值对。

pluralCategories

一个 Array 给定区域设置使用的复数类别,从列表 "zero""one""two""few""many""other" 中选择。

type

使用的类型 (cardinalordinal)。

roundingIncrement 实验性

舍入增量精度(舍入数字时使用的增量)。这是在构造函数中的 options.roundingIncrement 参数中指定的 value。

roundingMode 实验性

舍入模式。这是在构造函数中为 options.roundingMode 参数提供的 value,或默认 value:halfExpand

roundingPriority 实验性

如果同时指定了“FractionDigits”和“SignificantDigits”,则用于解决舍入冲突的优先级。这是在构造函数中为 options.roundingPriority 参数提供的 value,或默认 value:auto

trailingZeroDisplay 实验性

显示整数后缀零的策略。这是在构造函数中的 options.trailingZeroDisplay 参数中指定的 value,或默认 value:“auto”。

仅包含以下两个属性组之一

minimumIntegerDigitsminimumFractionDigitsmaximumFractionDigits

options 参数中为这些属性提供的 value 或作为默认值填充。仅当 options 参数中既未提供 minimumSignificantDigits 也未提供 maximumSignificantDigits 时,才会出现这些属性。

minimumSignificantDigitsmaximumSignificantDigits

options 参数中为这些属性提供的 value 或作为默认值填充。仅当在 options 参数中至少提供其中一个时,才会出现这些属性。

示例

使用 resolvedOptions() 方法

以下代码显示了 PluralRules 对象的构造,以及随后对每个解析选项的记录。

js
// Create a PluralRules instance
const de = new Intl.PluralRules("de-DE", {
  maximumSignificantDigits: 2,
  trailingZeroDisplay: "auto",
});

// Resolve the options
const usedOptions = de.resolvedOptions();
console.log(usedOptions.locale); // "de-DE"
console.log(usedOptions.pluralCategories); // Array ["one", "other"]
console.log(usedOptions.type); // "cardinal"
console.log(usedOptions.minimumIntegerDigits); // 1
console.log(usedOptions.minimumFractionDigits); // undefined (maximumSignificantDigits is set)
console.log(usedOptions.maximumFractionDigits); //undefined (maximumSignificantDigits is set)
console.log(usedOptions.minimumSignificantDigits); // 1
console.log(usedOptions.maximumSignificantDigits); //2
console.log(usedOptions.roundingIncrement); // 1
console.log(usedOptions.roundingMode); // "halfExpand"
console.log(usedOptions.roundingPriority); // "auto"
console.log(usedOptions.trailingZeroDisplay); // "auto"

规范

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

浏览器兼容性

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

另请参阅