Temporal.PlainDateTime.prototype.add()

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 add() von Temporal.PlainDateTime Instanzen gibt ein neues Temporal.PlainDateTime Objekt zurück, das dieses Datum-Zeit-Wert darstellt, verschoben um eine gegebene Dauer (in einer Form, die von Temporal.Duration.from() konvertierbar ist).

Syntax

add(duration)
add(duration, options)

Parameter

duration

Ein String, ein Objekt oder eine Temporal.Duration Instanz, die eine Dauer darstellt, die zu diesem Datum-Zeit-Wert hinzugefügt werden soll. Es wird in ein Temporal.Duration Objekt umgewandelt, indem der gleiche Algorithmus wie Temporal.Duration.from() verwendet wird.

options Optional

Ein Objekt, das die folgende Eigenschaft enthält:

overflow Optional

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 auf den gültigen Bereich geklemmmt.
"reject": Ein RangeError wird ausgelöst, wenn die Datumskomponente außerhalb des gültigen Bereichs liegt.

Rückgabewert

Ein neues Temporal.PlainDateTime Objekt, das den durch das ursprüngliche PlainDateTime und die Dauer angegebenen Datum-Zeit-Wert darstellt.

Ausnahmen

RangeError: Wird ausgelöst, wenn das Ergebnis nicht im darstellbaren Bereich liegt, was ±(10⁸ + 1) Tage oder etwa ±273.972,6 Jahre ab der Unix-Epoche sind.

const start = Temporal.PlainDateTime.from("2021-01-01T12:34:56");
const end = start.add({
  years: 1,
  months: 2,
  weeks: 3,
  days: 4,
  hours: 5,
  minutes: 6,
  seconds: 7,
  milliseconds: 8,
});
console.log(end.toString()); // 2022-03-26T17:41:03.008

Für weitere Beispiele, insbesondere wie verschiedene Kalender und die overflow Option mit Kalenderdauern interagieren, siehe Temporal.PlainDate.prototype.add().