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 subtract()-Methode von Instanzen des Temporal.ZonedDateTime gibt ein neues Temporal.ZonedDateTime-Objekt zurück, das diese Datums-Uhrzeit um eine gegebene Dauer (in einer Form, die von Temporal.Duration.from() konvertierbar ist) zurückbewegt darstellt.

Wenn Sie zwei Datums-Uhrzeiten subtrahieren und eine Dauer erhalten möchten, verwenden Sie stattdessen since() oder until().

Syntax

js
subtract(duration)
subtract(duration, options)

Parameter

duration

Ein String, ein Objekt oder eine Temporal.Duration-Instanz, die eine Dauer darstellt, die von dieser Datums-Uhrzeit subtrahiert werden soll. Es wird mit dem gleichen Algorithmus wie Temporal.Duration.from() in ein Temporal.Duration-Objekt konvertiert.

options Optional

Ein Objekt mit der folgenden Eigenschaft:

overflow Optional

Ein String, der das Verhalten festlegt, wenn eine Datumskomponente außerhalb des gültigen Bereichs liegt. Mögliche Werte sind:

"constrain" (Standard)

Die Datumskomponente wird auf den gültigen Bereich begrenzten.

"reject"

Es wird ein RangeError ausgelöst, wenn die Datumskomponente außerhalb des gültigen Bereichs liegt.

Rückgabewert

Ein neues Temporal.ZonedDateTime-Objekt, das die von der ursprünglichen ZonedDateTime angegebene Datums-Uhrzeit minus der Dauer darstellt.

Beschreibung

Das Subtrahieren einer Dauer ist gleichbedeutend mit dem Addieren ihrer Negation, sodass alle gleichen Überlegungen gelten.

Beispiele

Subtrahieren einer Dauer

js
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

BCD tables only load in the browser

Siehe auch