Intl.PluralRules.prototype.resolvedOptions()

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

¥The resolvedOptions() method of Intl.PluralRules instances returns a new object with properties reflecting the locale and plural formatting options computed during initialization of this Intl.PluralRules object.

Try it

语法

¥Syntax

js
resolvedOptions()

参数

¥Parameters

没有任何。

¥None.

返回值

¥Return value

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

¥A new object with properties reflecting the locale and plural formatting options computed during the initialization of the given Intl.PluralRules object.

该对象具有以下属性:

¥The object has the following properties:

locale

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

pluralCategories

给定语言环境使用的复数类别的 Array,从列表 "zero""one""two""few""many""other" 中选择。

type

使用的类型(cardinalordinal)。

roundingIncrement Experimental

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

roundingMode Experimental

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

roundingPriority Experimental

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

trailingZeroDisplay Experimental

在整数上显示尾随零的策略。这是构造函数中 options.trailingZeroDisplay 参数中指定的值,或者默认值:"auto"

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

¥Only one of the following two groups of properties is included:

minimumIntegerDigits, minimumFractionDigits, maximumFractionDigits

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

minimumSignificantDigitsmaximumSignificantDigits

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

示例

¥Examples

使用 resolvedOptions()方法

¥Using the resolvedOptions() method

下面的代码显示了 PluralRules 对象的构造,然后记录每个已解析的选项。

¥The code below shows the construction of a PluralRules object, followed by logging of each of the resolved options.

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"

规范

Specification
ECMAScript Internationalization API Specification
# sec-intl.pluralrules.prototype.resolvedoptions

¥Specifications

浏览器兼容性

BCD tables only load in the browser

¥Browser compatibility

也可以看看

¥See also