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 diesen Datum-Uhrzeit-Wert um eine bestimmte Dauer (in einer Form konvertierbar durch Temporal.Duration.from()) nach vorne verschoben darstellt.
Syntax
add(duration)
add(duration, options)
Parameter
duration-
Ein String, ein Objekt oder eine
Temporal.DurationInstanz, die eine Dauer darstellt, die zu diesem Datum-Uhrzeit-Wert hinzugefügt wird. Sie wird nach denselben Algorithmus wieTemporal.Duration.from()in einTemporal.DurationObjekt umgewandelt. optionsOptional-
Ein Objekt, das die folgende Eigenschaft enthält:
overflowOptional-
Ein String, der das Verhalten beschreibt, wenn eine Datumskomponente außerhalb des Bereichs liegt. Mögliche Werte sind:
"constrain"(Standard)-
Die Datumskomponente wird auf den gültigen Bereich eingeschränkt.
"reject"-
Ein
RangeErrorwird ausgelöst, wenn die Datumskomponente außerhalb des Bereichs liegt.
Rückgabewert
Ein neues Temporal.PlainDateTime Objekt, das das durch den ursprünglichen PlainDateTime spezifizierte Datum-Uhrzeit, plus der Dauer darstellt.
Ausnahmen
RangeError-
Wird ausgelöst, wenn das Ergebnis nicht im darstellbaren Bereich liegt, der ±(108 + 1) Tage, oder etwa ±273.972,6 Jahre, ab Unix-Epoche umfasst.
Beschreibung
Für Informationen, wie Kalenderdauern hinzugefügt werden, siehe Temporal.PlainDate.prototype.add().
Das Hinzufügen einer Dauer ist äquivalent zum Subtrahieren ihrer Negation.
Beispiele
Hinzufügen einer Dauer
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 mehr Beispiele, insbesondere darüber, wie verschiedene Kalender und die overflow Option mit Kalenderdauern interagieren, siehe Temporal.PlainDate.prototype.add().
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.add |