Temporal.Duration.prototype.subtract()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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. Dies entspricht dem Hinzufügen des negierten Werts der anderen Dauer.
Syntax
subtract(other)
Parameter
other-
Ein String, ein Objekt oder eine
Temporal.DurationInstanz, die eine Dauer darstellt, die zu dieser Dauer addiert werden soll. Es wird unter Verwendung desselben Algorithmus wieTemporal.Duration.from()in einTemporal.DurationObjekt umgewandelt.
Rückgabewert
Ein neues Temporal.Duration Objekt, das die Differenz dieser Dauer und other darstellt.
Ausnahmen
RangeError-
Wird in einem der folgenden Fälle ausgelöst:
- Entweder
thisoderotherist eine Kalenderdauer (sie hat eine nicht-nullyears,monthsoderweeks), da Kalenderdauern ohne Kalender- und Zeitreferenz mehrdeutig sind. - Die Differenz von
thisundotherüberschreitet den maximal oder unterschreitet den minimal darstellbaren Zeitraum, welcher ±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 mehr Beispiele und Hinweise sehen Sie die add() Methode.
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.duration.prototype.subtract |