Temporal.Instant.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 Instanzen des Temporal.Instant gibt ein neues Temporal.Instant-Objekt zurück, das diesen Moment um eine gegebene Dauer (in einer Form, die durch Temporal.Duration.from() konvertierbar ist) rückwärts verschoben darstellt.
Wenn Sie zwei Instanzen subtrahieren und eine Dauer erhalten möchten, verwenden Sie stattdessen since() oder until().
Syntax
subtract(duration)
Parameter
duration-
Ein String, ein Objekt oder eine
Temporal.Duration-Instanz, die eine Dauer darstellt, die von diesem Moment subtrahiert werden soll. Es wird mit demselben Algorithmus wieTemporal.Duration.from()in einTemporal.Duration-Objekt konvertiert.
Rückgabewert
Ein neues Temporal.Instant-Objekt, das die Subtraktion von duration von diesem Moment darstellt. Wenn duration positiv ist, dann ist der zurückgegebene Moment früher als dieser Moment; wenn duration negativ ist, dann ist der zurückgegebene Moment später als dieser Moment.
Ausnahmen
RangeError-
Wird in einem der folgenden Fälle ausgelöst:
durationist eine Kalenderdauer (sie hat ein von null verschiedenesyears,monthsoderweeks) oder hat ein von null verschiedenesdays, da Kalenderdauern ohne Kalender und Zeitreferenz mehrdeutig sind.- Der Unterschied von
thisunddurationüberschreitet das maximale oder unterschreitet das minimale darstellbare Moment, das ±108 Tage (etwa ±273.972,6 Jahre) beträgt.
Beschreibung
Beispiele
Subtrahieren einer Temporal.Duration
const instant = Temporal.Instant.fromEpochMilliseconds(1000);
const duration = Temporal.Duration.from("PT1S"); // One-second duration
const newInstant = instant.subtract(duration);
console.log(newInstant.epochMilliseconds); // 0
Für weitere Beispiele siehe add().
Spezifikationen
| Specification |
|---|
| Temporal proposal # sec-temporal.instant.prototype.subtract |
Browser-Kompatibilität
BCD tables only load in the browser