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 wieTemporal.Duration.from()
in einTemporal.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
oderother
ist eine Kalenderdauer (sie hat ein nicht-null Jahre, Monate oder Wochen), da Kalenderdauern ohne Kalender- und Zeitreferenz mehrdeutig sind. - Die Differenz von
this
undother
überschreitet die maximale oder unterschreitet die minimale darstellbare Dauer, die ±253 Sekunden beträgt.
- Entweder
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 |