Temporal.PlainTime : méthode add()
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 add() des instances de Temporal.PlainTime retourne un nouvel objet Temporal.PlainTime représentant cette heure avancée d'une durée donnée (sous une forme convertible par Temporal.Duration.from()), en faisant le tour de l'horloge si nécessaire.
Syntaxe
add(duration)
Paramètres
duration-
Une chaîne de caractères, un objet ou une instance de
Temporal.Durationreprésentant une durée à ajouter à cette heure. Elle est convertie en objetTemporal.Durationen utilisant le même algorithme queTemporal.Duration.from().
Valeur de retour
Un nouvel objet Temporal.PlainTime représentant l'heure définie par le PlainTime d'origine, plus la durée. Toutes les unités supérieures à hours sont ignorées, et si l'heure dépasse minuit, elle revient au jour suivant.
Ajouter une durée équivaut à soustraire sa négation.
Exemples
Ajouter une durée
const start = Temporal.PlainTime.from("12:34:56");
const end = start.add({ hours: 1, minutes: 30 });
console.log(end.toString()); // 14:04:56
const end2 = start.add({ hours: -1, minutes: -30 });
console.log(end2.toString()); // 11:04:56
const distance = Temporal.PlainTime.from("00:00:00").until("01:23:45"); // 1h 23m 45s
const end3 = start.add(distance);
console.log(end3.toString()); // 13:58:41
Basculer l'heure
Si l'heure dépasse minuit, elle passe au jour suivant :
const start = Temporal.PlainTime.from("12:34:56");
const end = start.add({ hours: 12 });
console.log(end.toString()); // 00:34:56
Spécifications
| Spécification |
|---|
| Temporal # sec-temporal.plaintime.prototype.add |
Compatibilité des navigateurs
Voir aussi
- L'objet
Temporal.PlainTime - L'objet
Temporal.Duration - La méthode
Temporal.PlainTime.prototype.subtract()