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.DurationInstanz, die eine Dauer darstellt, die zu dieser Dauer hinzugefügt werden soll. Es wird unter Verwendung des gleichen Algorithmus wieTemporal.Duration.from()in einTemporal.DurationObjekt 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
thisoderotherist eine Kalenderdauer (sie hat ein nicht-null Jahre, Monate oder Wochen), da Kalenderdauern ohne Kalender- und Zeitreferenz mehrdeutig sind. - Die Differenz von
thisundotherü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 |
Browser-Kompatibilität
Loading…