Intl.DurationFormat

可用性有限

此功能不是基线功能,因为它在一些最广泛使用的浏览器中无法工作。

**Intl.DurationFormat** 对象支持语言感知的持续时间格式化。

构造函数

Intl.DurationFormat()

创建一个新的 Intl.DurationFormat 对象。

静态方法

Intl.DurationFormat.supportedLocalesOf()

返回一个数组,其中包含提供的区域设置中那些无需回退到运行时默认区域设置即可支持的区域设置。

实例属性

这些属性定义在 Intl.DurationFormat.prototype 上,并由所有 Intl.DurationFormat 实例共享。

Intl.DurationFormat.prototype.constructor

创建实例对象的构造函数。对于 Intl.DurationFormat 实例,初始值为 Intl.DurationFormat 构造函数。

Intl.DurationFormat.prototype[Symbol.toStringTag]

[Symbol.toStringTag] 属性的初始值为字符串 "Intl.DurationFormat"。此属性用于 Object.prototype.toString()

实例方法

Intl.DurationFormat.prototype.format()

根据此 DurationFormat 对象的区域设置和格式化选项格式化持续时间的 Getter 函数。

Intl.DurationFormat.prototype.formatToParts()

返回一个 Array,其中包含表示格式化持续时间各部分的对象。

Intl.DurationFormat.prototype.resolvedOptions()

返回一个新对象,其属性反映在对象初始化期间计算出的区域设置和格式化选项。

示例

使用 Intl.DurationFormat

以下示例演示如何使用 Intl.DurationFormat 对象以各种区域设置和样式格式化持续时间对象。

js
const duration = {
  hours: 1,
  minutes: 46,
  seconds: 40,
};

// With style set to "long" and locale "fr-FR"
new Intl.DurationFormat("fr-FR", { style: "long" }).format(duration);
// "1 heure, 46 minutes et 40 secondes"

// With style set to "short" and locale "en"
new Intl.DurationFormat("en", { style: "short" }).format(duration);
// "1 hr, 46 min and 40 sec"

// With style set to "narrow" and locale "pt"
new Intl.DurationFormat("pt", { style: "narrow" }).format(duration);
// "1h 46min 40s"

规范

规范
Intl.DurationFormat
# durationformat-objects

浏览器兼容性

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

另请参阅