Temporal.PlainDate.prototype.subtract()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die Methode subtract() von Temporal.PlainDate-Instanzen gibt ein neues Temporal.PlainDate-Objekt zurück, das dieses Datum um eine angegebene Dauer zurückversetzt darstellt. Die Dauer muss in eine von Temporal.Duration.from() unterstützte Form konvertierbar sein.
Wenn Sie zwei Datumswerte voneinander subtrahieren und eine Dauer erhalten möchten, verwenden Sie stattdessen since() oder until().
Syntax
subtract(duration)
subtract(duration, options)
Parameter
duration-
Eine Zeichenfolge, ein Objekt oder eine
Temporal.Duration-Instanz, die eine von diesem Datum abzuziehende Dauer darstellt. Der Wert wird mit demselben Algorithmus wie beiTemporal.Duration.from()in einTemporal.Duration-Objekt umgewandelt. optionsOptional-
Ein Objekt mit der folgenden Eigenschaft:
overflowOptional-
Eine Zeichenfolge, die das Verhalten festlegt, wenn eine Datumskomponente außerhalb des gültigen Bereichs liegt. Mögliche Werte sind:
"constrain"(Standardwert)-
Die Datumskomponente wird auf den gültigen Bereich begrenzt.
"reject"-
Ein
RangeErrorwird ausgelöst, wenn die Datumskomponente außerhalb des gültigen Bereichs liegt.
Rückgabewert
Ein neues Temporal.PlainDate-Objekt, das das durch das ursprüngliche PlainDate angegebene Datum abzüglich der Dauer darstellt.
Ausnahmen
RangeError-
Wird ausgelöst, wenn das Ergebnis außerhalb des darstellbaren Bereichs liegt. Dieser umfasst ±(108 + 1) Tage beziehungsweise ungefähr ±273.972,6 Jahre, gerechnet ab der Unix-Epoche.
Beschreibung
Das Subtrahieren einer Dauer entspricht dem Addieren ihrer Negation. Daher gelten dieselben Überlegungen.
Beispiele
Eine Dauer 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
Weitere Beispiele finden Sie unter add().
Spezifikationen
| Spezifikation |
|---|
| Temporal # sec-temporal.plaindate.prototype.subtract |