Temporal.PlainDate : 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.PlainDate retourne un nouvel objet Temporal.Duration représentant la durée entre cette date et une autre date (sous une forme convertible par Temporal.PlainDate.from()). La durée est positive si l'autre date est après cette date, et négative si elle est avant.
Cette méthode effectue other - this. Pour effectuer 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.PlainDatereprésentant une date à soustraire de cette date. Elle est convertie en un objetTemporal.PlainDateen utilisant le même algorithme queTemporal.PlainDate.from(). Elle doit avoir le même calendrier quethis. optionsFacultatif-
Les mêmes options que
since().
Valeur de retour
Un nouvel objet Temporal.Duration représentant la durée entre cette date et other. La durée est positive si other est après cette date, et négative si elle est avant.
Exceptions
RangeError-
Levée dans l'un des cas suivants :
othera un calendrier différent dethis.- L'une des options est invalide.
Exemples
Utiliser la méthode until()
const launch = Temporal.PlainDate.from("2035-01-01");
const now = Temporal.Now.plainDateISO();
const duration = now.until(launch);
console.log(`Il reste ${duration.toLocaleString("fr-FR")} avant le lancement`);
Pour plus d'exemples, voir since().
Spécifications
| Spécification |
|---|
| Temporal # sec-temporal.plaindate.prototype.until |
Compatibilité des navigateurs
Voir aussi
- L'objet
Temporal.PlainDate - L'objet
Temporal.Duration - La méthode
Temporal.PlainDate.prototype.add() - La méthode
Temporal.PlainDate.prototype.subtract() - La méthode
Temporal.PlainDate.prototype.since()