Temporal.PlainTime : méthode subtract()
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 subtract() des instances de Temporal.PlainTime retourne un nouvel objet Temporal.PlainTime représentant cette heure reculé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.
Si vous souhaitez soustraire deux heures et obtenir une durée, utilisez plutôt since() ou until().
Syntaxe
subtract(duration)
Paramètres
duration-
Une chaîne de caractères, un objet ou une instance de
Temporal.Durationreprésentant une durée à soustraire de 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 original, moins la durée.
Soustraire une durée équivaut à ajouter sa négation, donc toutes les mêmes considérations s'appliquent.
Exemples
Soustraire une durée
const start = Temporal.PlainTime.from("12:34:56");
const end = start.subtract({ hours: 1, minutes: 30 });
console.log(end.toString()); // 11:04:56
Pour plus d'exemples, voir add().
Spécifications
| Spécification |
|---|
| Temporal # sec-temporal.plaintime.prototype.subtract |
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.since() - La méthode
Temporal.PlainTime.prototype.until()