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 Temporal.Instant-Instanzen gibt ein neues Temporal.Instant-Objekt zurück, das diesen Zeitpunkt um eine angegebene Dauer (in einer Form, die durch Temporal.Duration.from() umwandelbar ist) rückwärts verschoben darstellt.
Wenn Sie zwei Zeitpunkte 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 Zeitpunkt subtrahiert werden soll. Es wird unter Verwendung desselben Algorithmus in einTemporal.Duration-Objekt umgewandelt wieTemporal.Duration.from().
Rückgabewert
Ein neues Temporal.Instant-Objekt, das die Subtraktion von duration von diesem Zeitpunkt darstellt. Wenn duration positiv ist, liegt der zurückgegebene Zeitpunkt vor diesem Zeitpunkt; wenn duration negativ ist, liegt der zurückgegebene Zeitpunkt nach diesem Zeitpunkt.
Ausnahmen
RangeError-
Wird in einem der folgenden Fälle ausgelöst:
durationist eine Kalenderdauer (sie hat ein von null abweichendesyears,monthsoderweeks), oder hat ein von null abweichendesdays, da Kalenderdauern ohne einen Kalender und Zeitbezug mehrdeutig sind.- Das Ergebnis liegt nicht im darstellbaren Bereich, der ±108 Tage oder etwa ±273.972,6 Jahre ab der Unix-Epoche umfasst.
Beschreibung
Das Subtrahieren einer Dauer entspricht dem Hinzufügen ihrer Negation, daher gelten dieselben Überlegungen.
Beispiele
Eine Temporal.Duration subtrahieren
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 # sec-temporal.instant.prototype.subtract |