Temporal.PlainTime : 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.PlainTime retourne un nouvel objet Temporal.Duration représentant la durée entre cette heure et une autre heure (sous une forme convertible par Temporal.PlainTime.from()). La durée est positive si l'autre heure est après cette 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.PlainTimereprésentant une heure à soustraire de cette heure. Il est converti en objetTemporal.PlainTimeen utilisant le même algorithme queTemporal.PlainTime.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 cette heure et other. La durée est positive si other est après cette heure, et négative si elle est avant.
Exceptions
RangeError-
Levée si l'une des options est invalide.
Exemples
Utiliser la méthode until()
const lunchTime = Temporal.PlainTime.from("12:30:00");
const now = Temporal.Now.plainTimeISO();
const duration = now.until(lunchTime);
console.log(`Il restera ${duration.toLocaleString("fr-FR")} avant le déjeuner`);
// Sortie d'exemple : "Il restera -3 h, 7 min, 10 s et 244 ms avant le déjeuner"
Pour plus d'exemples, voir la méthode since().
Spécifications
| Spécification |
|---|
| Temporal # sec-temporal.plaintime.prototype.until |
Compatibilité des navigateurs
Voir aussi
- L'objet
Temporal.PlainTime - L'objet
Temporal.Duration - La méthode
Temporal.PlainTime.prototype.add() - La méthode
Temporal.PlainTime.prototype.subtract() - La méthode
Temporal.PlainTime.prototype.since()