Intl.DurationFormat

Baseline 2025

Nouvellement disponible

Depuis March 2025, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

L'objet Intl.DurationFormat permet la mise en forme des durées sensible à la langue.

Dans cet article

Constructeur

Intl.DurationFormat()

Crée un nouvel objet Intl.DurationFormat.

Méthodes statiques

Intl.DurationFormat.supportedLocalesOf()

Retourne un tableau contenant celles des locales fournies qui sont prises en charge sans avoir à revenir à la locale par défaut de l'environnement d'exécution.

Propriétés d'instance

Ces propriétés sont définies sur Intl.DurationFormat.prototype et partagées par toutes les instances de Intl.DurationFormat.

Intl.DurationFormat.prototype.constructor

La fonction constructeur qui a créé l'objet d'instance. Pour les instances de Intl.DurationFormat, la valeur initiale est le constructeur Intl.DurationFormat.

Intl.DurationFormat.prototype[Symbol.toStringTag]

La valeur initiale de la propriété [Symbol.toStringTag] est la chaîne de caractères "Intl.DurationFormat". Cette propriété est utilisée dans Object.prototype.toString().

Méthodes d'instance

Intl.DurationFormat.prototype.format()

Fonction accesseur qui met en forme une durée selon la locale et les options de mise en forme de cet objet DurationFormat.

Intl.DurationFormat.prototype.formatToParts()

Retourne un tableau (Array) d'objets représentant la durée mise en forme en parties.

Intl.DurationFormat.prototype.resolvedOptions()

Retourne un nouvel objet avec des propriétés reflétant la locale et les options de mise en forme calculées lors de l'initialisation de l'objet.

Exemples

Utiliser Intl.DurationFormat

Les exemples ci-dessous montrent comment utiliser l'objet Intl.DurationFormat pour mettre en forme un objet de durée avec différentes locales et styles.

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

// Avec le style défini sur "long" et la locale "fr-FR"
new Intl.DurationFormat("fr-FR", { style: "long" }).format(duration);
// "1 heure, 46 minutes et 40 secondes"

// Avec le style défini sur "short" et la locale "en"
new Intl.DurationFormat("en", { style: "short" }).format(duration);
// "1 hr, 46 min and 40 sec"

// Avec le style défini sur "narrow" et la locale "pt"
new Intl.DurationFormat("pt", { style: "narrow" }).format(duration);
// "1 h 46 min 40 s"