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 von Temporal.Duration-Instanzen gibt ein neues Temporal.Duration-Objekt mit der Differenz zwischen dieser Dauer und einer gegebenen Dauer zurück. Sie ist äquivalent zum Hinzufügen des negierten Wertes der anderen Dauer.
Syntax
subtract(other)
Parameter
other-
Ein String, ein Objekt oder eine
Temporal.Duration-Instanz, die eine hinzuzufügende Dauer zu dieser Dauer darstellt. Es wird in einTemporal.Duration-Objekt umgewandelt, indem derselbe Algorithmus wie beiTemporal.Duration.from()verwendet wird.
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
thisoderotherist eine Kalenderdauer (sie hat einen von null verschiedenen Wert füryears,monthsoderweeks), da Kalenderdauern ohne einen Kalender und Zeitbezug mehrdeutig sind. - Die Differenz von
thisundotherüberschreitet die maximal darstellbare Dauer oder unterschreitet die minimal 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 Besonderheiten siehe die add()-Methode.
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.duration.prototype.subtract |