Temporal.PlainDateTime.prototype.add()

duration

Ein String, ein Objekt oder eine Temporal.Duration-Instanz, die eine hinzuzufügende Dauer zu diesem Datum-Uhrzeit-Wert darstellt. Diese wird mithilfe des gleichen Algorithmus wie Temporal.Duration.from() in ein Temporal.Duration-Objekt umgewandelt.

options Optional

Ein Objekt, das die folgende Eigenschaft enthält:

overflow Optional

Ein String, der das Verhalten bei einem ungültigen Datumsbestandteil spezifiziert. Mögliche Werte sind:

"constrain" (Standard)

Der Datumsbestandteil wird auf den gültigen Bereich begrenzt.

"reject"

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

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

RangeError

Wird ausgelöst, wenn das Ergebnis nicht im darstellbaren Bereich liegt, der ±(10⁸ + 1) Tage oder etwa ±273.972,6 Jahre vom Unix-Epoch umfasst.

Wie Kalenderdauern hinzugefügt werden, finden Sie unter Temporal.PlainDate.prototype.add().

Das Hinzufügen einer Dauer entspricht dem Subtrahieren ihrer Negation.

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

• Temporal.PlainDateTime
• Temporal.Duration
• Temporal.PlainDateTime.prototype.subtract()