Temporal.PlainDateTime.prototype.add()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die add() Methode von Temporal.PlainDateTime Instanzen gibt ein neues Temporal.PlainDateTime Objekt zurück, das diesen Datum-Uhrzeit-Wert darstellt, der um eine gegebene Dauer nach vorne verschoben ist (in einer Form, die durch Temporal.Duration.from() konvertierbar ist).

Syntax

add(duration)
add(duration, options)

Parameter

duration

Ein String, ein Objekt oder eine Instanz von Temporal.Duration, die eine Dauer darstellt, die zu diesem Datum-Uhrzeit-Wert hinzugefügt wird. Es wird unter Verwendung desselben Algorithmus wie Temporal.Duration.from() in ein Temporal.Duration Objekt konvertiert.

options Optional

Ein Objekt, das die folgende Eigenschaft enthält:

overflow Optional

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

"constrain" (Standard): Die Datumskomponente wird eingeschränkt auf den gültigen Bereich.
"reject": Ein RangeError wird ausgelöst, wenn die Datumskomponente außerhalb des Bereichs liegt.

Rückgabewert

Ein neues Temporal.PlainDateTime Objekt, das das durch das ursprüngliche PlainDateTime spezifizierte Datum und Uhrzeit plus der Dauer darstellt.

Ausnahmen

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

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 Option overflow mit Kalenderdauern interagieren, siehe Temporal.PlainDate.prototype.add().