Temporal.PlainYearMonth : 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.PlainYearMonth retourne un nouvel objet Temporal.Duration représentant la durée entre de ce mois et son année et d'un autre mois et son année (sous une forme convertible par Temporal.PlainYearMonth.from()). La durée est positive si l'autre mois est après ce mois, et négative si 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.PlainYearMonthreprésentant un mois et une année à soustraire de ce mois et cette année. Il est converti en objetTemporal.PlainYearMonthen utilisant le même algorithme queTemporal.PlainYearMonth.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 entre ce mois et son année jusqu'à other. La durée est positive si other est après ce mois et son année, et négative si avant.
Exceptions
RangeError-
Levée dans l'un des cas suivants :
otherutilise un calendrier différent de celui dethis.- Aucune des options n'est valide.
Exemples
Utiliser la méthode until()
const launch = Temporal.PlainYearMonth.from("2035-01");
const now = Temporal.Now.plainDateISO().toPlainYearMonth();
const duration = now.until(launch);
console.log(
`Il restera ${duration.toLocaleString("fr-FR")} jusqu'au lancement.`,
);
Pour plus d'exemples, voir since().
Spécifications
| Spécification |
|---|
| Temporal # sec-temporal.plainyearmonth.prototype.until |
Compatibilité des navigateurs
Voir aussi
- L'objet
Temporal.PlainYearMonth - L'objet
Temporal.Duration - La méthode
Temporal.PlainYearMonth.prototype.add() - La méthode
Temporal.PlainYearMonth.prototype.subtract() - La méthode
Temporal.PlainYearMonth.prototype.since()