Temporal.PlainDateTime : 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.PlainDateTime 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.PlainDateTime.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 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.PlainDateTimereprésentant une date et heure dont soustraire cette date et heure. Il est converti en un objetTemporal.PlainDateTimeen utilisant le même algorithme queTemporal.PlainDateTime.from(). Il 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 de cette date et heure jusqu'à 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 :
othera un calendrier différent dethis.- Une des options est invalide.
Exemples
Utiliser la méthode until()
let nextBilling = Temporal.PlainDateTime.from({
year: Temporal.Now.plainDateISO().year,
month: 4,
day: 1,
});
const now = Temporal.Now.plainDateTimeISO().round("second");
if (Temporal.PlainDateTime.compare(nextBilling, now) < 0) {
nextBilling = nextBilling.add({ years: 1 });
}
const duration = now.until(nextBilling);
console.log(
`${duration.toLocaleString("fr-FR")} jusqu'à la prochaine facturation`,
);
Pour plus d'exemples, voir since().
Spécifications
| Spécification |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.until |