Temporal.PlainDate.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.PlainDate Instanzen gibt ein neues Temporal.PlainDate-Objekt zurück, das dieses Datum um eine gegebene Dauer (in einer Form umwandelbar durch Temporal.Duration.from()) zurückversetzt darstellt.
Wenn Sie zwei Daten subtrahieren und eine Dauer erhalten möchten, verwenden Sie stattdessen since() oder until().
Syntax
subtract(duration)
subtract(duration, options)
Parameter
duration-
Ein String, ein Objekt oder eine
Temporal.DurationInstanz, die eine von diesem Datum abzuziehende Dauer darstellt. Sie wird mit demselben Algorithmus wieTemporal.Duration.from()in einTemporal.Duration-Objekt umgewandelt. optionsOptional-
Ein Objekt, das die folgende Eigenschaft enthält:
overflowOptional-
Ein String, der das Verhalten angibt, wenn eine Datumskomponente außerhalb des gültigen Bereichs liegt. Mögliche Werte sind:
"constrain"(Standard)-
Die Datumskomponente wird innerhalb des gültigen Bereichs eingeschränkt.
"reject"-
Ein
RangeErrorwird geworfen, wenn die Datumskomponente außerhalb des Bereichs liegt.
Rückgabewert
Ein neues Temporal.PlainDate-Objekt, das das durch das ursprüngliche PlainDate angegebene Datum minus der Dauer darstellt.
Beschreibung
Das Subtrahieren einer Dauer entspricht dem Addieren ihrer Negation, sodass alle gleichen Überlegungen zutreffen.
Ausnahmen
RangeError-
Wird geworfen, wenn das Ergebnis nicht im darstellbaren Bereich liegt, der ±(108 + 1) Tage oder etwa ±273,972.6 Jahre ab der Unix-Epoche umfasst.
Beispiele
Subtrahieren einer Dauer
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 |
Browser-Kompatibilität
Loading…