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.DurationInstanz, die eine Dauer darstellt, die zu diesem Datum-Zeit-Wert hinzugefügt werden soll. Es wird in einTemporal.DurationObjekt umgewandelt, indem der gleiche Algorithmus wieTemporal.Duration.from()verwendet wird. optionsOptional-
Ein Objekt, das die folgende Eigenschaft enthält:
overflowOptional-
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
RangeErrorwird 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 ±(108 + 1) Tage oder etwa ±273.972,6 Jahre ab der Unix-Epoche sind.
Beschreibung
Wie Kalenderdauern hinzugefügt werden, erfahren Sie im Temporal.PlainDate.prototype.add().
Das Hinzufügen einer Dauer entspricht dem 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 weitere Beispiele, insbesondere wie verschiedene Kalender und die overflow Option mit Kalenderdauern interagieren, siehe Temporal.PlainDate.prototype.add().
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.add |