Temporal.Duration : méthode subtract()

Syntaxe

subtract(other)

Paramètres

other

Une chaîne de caractères, un objet ou une instance de Temporal.Duration représentant une durée à soustraire de cette durée. Elle est convertie en un objet Temporal.Duration en utilisant le même algorithme que Temporal.Duration.from().

Valeur de retour

Un nouvel objet Temporal.Duration représentant la différence entre cette durée et other.

Exceptions

RangeError

Levée dans l'un des cas suivants :

• Soit this ou other est une durée calendaire (ses valeurs years, months ou weeks sont différentes de zéro), car les durées calendaires sont ambiguës sans référence à un calendrier et à une heure.
• La différence entre this et other dépasse la durée maximale ou descend en dessous de la durée minimale représentable, qui est de ±2⁵³ secondes.

Exemples

Utiliser la méthode subtract()

const d1 = Temporal.Duration.from({ hours: 1, minutes: 30 });
const d2 = Temporal.Duration.from({ hours: -1, minutes: -20 });

const d3 = d1.subtract(d2);
console.log(d3.toString()); // "PT2H50M"

Pour plus d'exemples et de mises en garde, voir la méthode add().

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet Temporal.Duration
• La méthode Temporal.Duration.prototype.add()
• La méthode Temporal.Duration.prototype.negated()