Temporal.ZonedDateTime : méthode until()

Disponibilité limitée

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

La méthode until() des instances de Temporal.ZonedDateTime retourne un nouvel objet Temporal.Duration représentant la durée entre cette date et heure et une autre date et heure (sous une forme convertible par Temporal.ZonedDateTime.from()). La durée est positive si l'autre date et heure est après cette date et heure, et négative si elle est avant.

Cette méthode fait other - this. Pour faire this - other, utilisez la méthode since().

Syntaxe

until(other)
until(other, options)

Paramètres

other: Une chaîne de caractères, un objet ou une instance de Temporal.ZonedDateTime représentant une date et heure à soustraire de cette date et heure. Il est converti en objet Temporal.ZonedDateTime en utilisant le même algorithme que Temporal.ZonedDateTime.from(). Il doit avoir le même calendrier que this.
options Facultatif: Les mêmes options que since().

Valeur de retour

Un nouvel objet Temporal.Duration représentant la durée entre cette date et heure et other. La durée est positive si other est après cette date et heure, et négative si elle est avant.

Exceptions

RangeError

Levée dans l'un des cas suivants :

other a un calendrier différent de this.
L'une des options est invalide.
other a un fuseau horaire différent de this, et largestUnit est "days" ou plus.

Exemples

Utiliser la méthode `until()`

const flight = Temporal.ZonedDateTime.from(
  "2024-12-21T13:31:00-05:00[America/New_York]",
);
const now = Temporal.Now.zonedDateTimeISO("America/New_York").round("second");
if (Temporal.ZonedDateTime.compare(flight, now) < 0) {
  console.error(
    "Le vol est déjà passé. Le résultat peut ne pas avoir de sens.",
  );
}
const duration = now.until(flight, { largestUnit: "days" });
console.log(`Le vol est dans ${duration.toLocaleString("fr-FR")}`);

Pour plus d'exemples, voir since().

Spécifications

Spécification
Temporal # sec-temporal.zoneddatetime.prototype.until

Compatibilité des navigateurs

Voir aussi

L'objet Temporal.ZonedDateTime
L'objet Temporal.Duration
La méthode Temporal.ZonedDateTime.prototype.add()
La méthode Temporal.ZonedDateTime.prototype.subtract()
La méthode Temporal.ZonedDateTime.prototype.since()

Aider à améliorer MDN

Apprendre à contribuer

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

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