Temporal.ZonedDateTime.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 Methode subtract()
von Instanzen von Temporal.ZonedDateTime
gibt ein neues Temporal.ZonedDateTime
-Objekt zurück, welches diesen Zeitpunkt um eine angegebene Dauer (in einer Form, die durch Temporal.Duration.from()
konvertierbar ist) zurückversetzt darstellt.
Wenn Sie zwei Zeitpunkte voneinander abziehen 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.Duration
-Instanz, die eine Dauer darstellt, welche von diesem Zeitpunkt abgezogen werden soll. Es wird mit demselben Algorithmus wie beiTemporal.Duration.from()
in einTemporal.Duration
-Objekt konvertiert. options
Optional-
Ein Objekt, das folgende Eigenschaft enthält:
overflow
Optional-
Ein String, der das Verhalten bestimmt, wenn eine Datums-Komponente außerhalb des Bereichs liegt. Mögliche Werte sind:
"constrain"
(Standard)-
Die Datums-Komponente wird auf den gültigen Bereich begrenzt.
"reject"
-
Ein
RangeError
wird ausgelöst, wenn die Datums-Komponente außerhalb des Bereichs liegt.
Rückgabewert
Ein neues Temporal.ZonedDateTime
-Objekt, das den durch den ursprünglichen ZonedDateTime
festgelegten Zeitpunkt minus der Dauer darstellt.
Ausnahmen
RangeError
-
Wird ausgelöst, wenn das Ergebnis nicht im darstellbaren Bereich liegt, der ±108 Tage oder etwa ±273.972,6 Jahre ab der Unix-Epoche beträgt.
Beschreibung
Beispiele
Eine Dauer subtrahieren
const start = Temporal.ZonedDateTime.from(
"2021-01-01T12:34:56-05:00[America/New_York]",
);
const end = start.subtract({
years: 1,
months: 2,
weeks: 3,
days: 4,
hours: 5,
minutes: 6,
seconds: 7,
milliseconds: 8,
});
console.log(end.toString()); // 2019-10-07T07:28:48.992-04:00[America/New_York]
Spezifikationen
Specification |
---|
Temporal proposal # sec-temporal.zoneddatetime.prototype.subtract |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
subtract |
Legend
Tip: you can click/tap on a cell for more information.
- No support
- No support
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- User must explicitly enable this feature.