Intl.DurationFormat.prototype.resolvedOptions()

基准线 2025
新推出

自 ⁨2025 年 3 月⁩ 起,此功能可在最新的设备和浏览器版本上使用。此功能可能在旧设备或浏览器上无法正常工作。

Intl.DurationFormat 实例的 resolvedOptions() 方法返回一个新对象,该对象包含在初始化此 DurationFormat 对象期间计算的选项属性。

语法

js
resolvedOptions()

参数

无。

返回值

一个新对象,包含在初始化此 DurationFormat 对象期间计算的选项属性。该对象按列出顺序包含以下属性:

locale

通过 区域设置协商 过程确定的实际使用的区域设置的 BCP 47 语言标签。输出中可能只包含请求的 nu Unicode 扩展键(如果已请求)。

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

浏览器兼容性

另见