Temporal.Duration.prototype.subtract()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die subtract() Methode der Temporal.Duration Instanzen gibt ein neues Temporal.Duration Objekt zurück, das die Differenz zwischen dieser Dauer und einer gegebenen Dauer darstellt. Sie ist äquivalent dazu, den negierten Wert der anderen Dauer hinzuzufügen.

Syntax

subtract(other)

Parameter

other: Ein String, ein Objekt oder eine Temporal.Duration Instanz, die eine Dauer darstellt, die zu dieser Dauer hinzugefügt werden soll. Es wird unter Verwendung des gleichen Algorithmus wie Temporal.Duration.from() in ein Temporal.Duration Objekt konvertiert.

Rückgabewert

Ein neues Temporal.Duration Objekt, das die Differenz zwischen dieser Dauer und other darstellt.

Ausnahmen

RangeError

Wird in einem der folgenden Fälle ausgelöst:

Entweder this oder other ist eine Kalenderdauer (sie hat ein nicht-null Jahre, Monate oder Wochen), da Kalenderdauern ohne Kalender- und Zeitreferenz mehrdeutig sind.
Die Differenz von this und other überschreitet die maximale oder unterschreitet die minimale darstellbare Dauer, die ±2⁵³ Sekunden beträgt.

Beispiele

Verwendung von 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"

Für weitere Beispiele und Hinweise siehe die add() Methode.

Spezifikationen

Specification
Temporal # sec-temporal.duration.prototype.subtract