Temporal.PlainDate.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.PlainDate-Instanzen gibt ein neues Temporal.PlainDate-Objekt zurück, das dieses Datum um eine angegebene Zeitspanne (in einer Form, die von Temporal.Duration.from() umgewandelt werden kann) rückwärts verschoben darstellt.
Wenn Sie zwei Daten subtrahieren und eine Zeitspanne erhalten möchten, verwenden Sie stattdessen since() oder until().
Syntax
subtract(duration)
subtract(duration, options)
Parameter
duration-
Ein String, ein Objekt oder eine
Temporal.Duration-Instanz, die eine Zeitspanne darstellt, die von diesem Datum subtrahiert werden soll. Sie wird mit demselben Algorithmus in einTemporal.Duration-Objekt umgewandelt wieTemporal.Duration.from(). optionsOptional-
Ein Objekt, das die folgende Eigenschaft enthält:
overflowOptional-
Ein String, der das Verhalten angibt, wenn eine Datumskomponente außerhalb des Bereichs liegt. Mögliche Werte sind:
"constrain"(Standard)-
Die Datumskomponente wird auf den gültigen Bereich eingeklemmt.
"reject"-
Ein
RangeErrorwird ausgelöst, wenn die Datumskomponente außerhalb des Bereichs liegt.
Rückgabewert
Ein neues Temporal.PlainDate-Objekt, das das Datum darstellt, das durch das ursprüngliche PlainDate minus die Zeitspanne angegeben wird.
Beschreibung
Das Subtrahieren einer Zeitspanne entspricht dem Addieren ihrer Negation, daher gelten alle gleichen Überlegungen.
Ausnahmen
RangeError-
Wird ausgelöst, wenn das Ergebnis nicht im darstellbaren Bereich liegt, was ±(108 + 1) Tage oder etwa ±273.972,6 Jahre ab der Unix-Epoche sind.
Beispiele
Eine Zeitspanne subtrahieren
const start = Temporal.PlainDate.from("2022-01-01");
const end = start.subtract({ years: 1, months: 2, weeks: 3, days: 4 });
console.log(end.toString()); // 2020-10-07
Für weitere Beispiele siehe add().
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaindate.prototype.subtract |