Documentación offline JavaScript main
/ ó ⌘K

Intl.DurationFormat

main Documentación oficial Licencia CC-BY-SA-2.5Descargado el 2026-08-02

En esta página

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

Constructor#

  • {{jsxref("Intl/DurationFormat/DurationFormat", "Intl.DurationFormat()")}}
  • : Creates a new Intl.DurationFormat object.

Static methods#

  • {{jsxref("Intl/DurationFormat/supportedLocalesOf", "Intl.DurationFormat.supportedLocalesOf()")}}
  • : Returns an array containing those of the provided locales that are supported without having to fall back to the runtime's default locale.

Instance properties#

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

  • {{jsxref("Object/constructor", "Intl.DurationFormat.prototype.constructor")}}
  • : The constructor function that created the instance object. For Intl.DurationFormat instances, the initial value is the {{jsxref("Intl/DurationFormat/DurationFormat", "Intl.DurationFormat")}} constructor.
  • Intl.DurationFormat.prototype[Symbol.toStringTag]
  • : The initial value of the [Symbol.toStringTag] property is the string "Intl.DurationFormat". This property is used in {{jsxref("Object.prototype.toString()")}}.

Instance methods#

  • {{jsxref("Intl/DurationFormat/format", "Intl.DurationFormat.prototype.format()")}}
  • : Getter function that formats a duration according to the locale and formatting options of this DurationFormat object.
  • {{jsxref("Intl/DurationFormat/formatToParts", "Intl.DurationFormat.prototype.formatToParts()")}}
  • : Returns an {{jsxref("Array")}} of objects representing the formatted duration in parts.
  • {{jsxref("Intl/DurationFormat/resolvedOptions", "Intl.DurationFormat.prototype.resolvedOptions()")}}
  • : Returns a new object with properties reflecting the locale and formatting options computed during initialization of the object.

Examples#

Using 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);
// "1 h 46 min 40 s"

Specifications#

{{Specifications}}

Browser compatibility#

{{Compat}}

See also#