Intl.DurationFormat

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Intl.DurationFormat 对象启用语言敏感的持续时间格式。

¥The Intl.DurationFormat object enables language-sensitive duration formatting.

构造函数

¥Constructor

Intl.DurationFormat() Experimental

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

静态方法

¥Static methods

Intl.DurationFormat.supportedLocalesOf() Experimental

返回一个数组,其中包含所提供的受支持的语言环境,而无需回退到运行时的默认语言环境。

实例属性

¥Instance properties

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

¥These properties are defined on Intl.DurationFormat.prototype and shared by all Intl.DurationFormat instances.

Intl.DurationFormat.prototype.constructor

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

Intl.DurationFormat.prototype[Symbol.toStringTag]

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

实例方法

¥Instance methods

Intl.DurationFormat.prototype.format() Experimental

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

Intl.DurationFormat.prototype.formatToParts() Experimental

返回代表格式化持续时间的对象的 Array 个部分。

Intl.DurationFormat.prototype.resolvedOptions() Experimental

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

示例

¥Examples

使用 Intl.DurationFormat

¥Using Intl.DurationFormat

下面的示例展示了如何使用 Intl.DurationFormat 对象来格式化具有各种区域设置和样式的持续时间对象。

¥The examples below show how to use the Intl.DurationFormat object to format a duration object with various locales and styles.

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"

规范

Specification
Intl.DurationFormat
# durationformat-objects

¥Specifications

浏览器兼容性

BCD tables only load in the browser

¥Browser compatibility

也可以看看

¥See also