Intl.DurationFormat

¥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

¥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.

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"

¥See also

• Intl