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 add() Methode von Temporal.PlainDateTime Instanzen gibt ein neues Temporal.PlainDateTime Objekt zurück, das diesen Zeitpunkt repräsentiert, der um eine angegebene Dauer nach vorne verschoben wurde (in einer Form, die durch Temporal.Duration.from() konvertierbar ist).

Syntax

js
add(duration)
add(duration, options)

Parameter

duration

Ein String, ein Objekt oder eine Temporal.Duration Instanz, die eine Dauer darstellt, die zu diesem Zeitpunkt hinzugefügt werden soll. Es wird unter Verwendung des gleichen Algorithmus in ein Temporal.Duration Objekt konvertiert wie Temporal.Duration.from().

options Optional

Ein Objekt, das die folgende Eigenschaft enthält:

overflow Optional

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

"constrain" (Standard)

Die Datums-Komponente wird auf den gültigen Bereich eingeschränkt.

"reject"

Ein RangeError wird ausgelöst, wenn die Datums-Komponente außerhalb des gültigen Bereichs liegt.

Rückgabewert

Ein neues Temporal.PlainDateTime Objekt, das den durch das ursprüngliche PlainDateTime spezifizierten Zeitpunkt plus die Dauer darstellt.

Beschreibung

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

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

Beispiele

Hinzufügen einer Dauer

js
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 sich verschiedene Kalender und die overflow Option auf Kalenderdauern auswirken, siehe Temporal.PlainDate.prototype.add().

Spezifikationen

Specification
Temporal proposal
# sec-temporal.plaindatetime.prototype.add

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch