Constructeur Temporal.Duration()

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

Le constructeur Temporal.Duration() crée des objets Temporal.Duration.

Ce constructeur permet de créer des instances en fournissant directement les données sous-jacentes. Comme pour toutes les autres classes Temporal, vous devriez généralement construire des objets Temporal.Duration en utilisant la méthode statique Temporal.Duration.from(), qui peut gérer une variété de types d'entrée.

Syntaxe

new Temporal.Duration()
new Temporal.Duration(years)
new Temporal.Duration(years, months)
new Temporal.Duration(years, months, weeks)
new Temporal.Duration(years, months, weeks, days)
new Temporal.Duration(years, months, weeks, days, hours)
new Temporal.Duration(years, months, weeks, days, hours, minutes)
new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds)
new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds, milliseconds)
new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds)
new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds)

Note : Temporal.Duration() ne peut être construit qu'avec new. Tenter de l'appeler sans new déclenche une TypeError.

Paramètres

years Facultatif: Nombre d'années, ou undefined (qui est traité comme 0).
months Facultatif: Nombre de mois, ou undefined (qui est traité comme 0).
weeks Facultatif: Nombre de semaines, ou undefined (qui est traité comme 0).
days Facultatif: Nombre de jours, ou undefined (qui est traité comme 0).
hours Facultatif: Nombre d'heures, ou undefined (qui est traité comme 0).
minutes Facultatif: Nombre de minutes, ou undefined (qui est traité comme 0).
seconds Facultatif: Nombre de secondes, ou undefined (qui est traité comme 0).
milliseconds Facultatif: Nombre de millisecondes, ou undefined (qui est traité comme 0).
microseconds Facultatif: Nombre de microsecondes, ou undefined (qui est traité comme 0).
nanoseconds Facultatif: Nombre de nanosecondes, ou undefined (qui est traité comme 0).

Valeur de retour

Un nouvel objet Temporal.Duration, éventuellement déséquilibré, avec les composants définis.

Exceptions

RangeError

Levée dans l'un des cas suivants :

L'un des paramètres n'est pas un nombre entier (y compris les valeurs non finies).
Une unité de calendrier (années, mois, semaines) a une valeur absolue ≥ 2³².
La partie non calendaire de la durée (jours et au-dessous), lorsqu'elle est exprimée en secondes, a une valeur absolue ≥ 2⁵³.

Exemples

Utiliser `Temporal.Duration()`

const d = new Temporal.Duration(1, 2, 3, 4, 5, 6, 7, 8, 9, 10);
console.log(d.toString()); // "P1Y2M3W4DT5H6M7.00800901S"

Spécifications

Spécification
Temporal # sec-temporal-duration-constructor

Compatibilité des navigateurs

Voir aussi

L'objet Temporal.Duration
La méthode statique Temporal.Duration.from()

Aider à améliorer MDN

Apprendre à contribuer

Cette page a été modifiée le 25 mars 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu