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 Datum-Uhrzeit-Wert um eine angegebene Dauer (in einer Form, die durch Temporal.Duration.from()
konvertierbar ist) nach vorne verschoben darstellt.
Syntax
add(duration)
add(duration, options)
Parameter
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 wieTemporal.Duration.from()
in einTemporal.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.
Rückgabewert
Ein neues Temporal.PlainDateTime
-Objekt, das das durch das ursprüngliche PlainDateTime
und die Dauer spezifizierte Datum-Uhrzeit darstellt.
Ausnahmen
RangeError
-
Wird ausgelöst, wenn das Ergebnis nicht im darstellbaren Bereich liegt, der ±(108 + 1) Tage oder etwa ±273.972,6 Jahre vom Unix-Epoch umfasst.
Beschreibung
Wie Kalenderdauern hinzugefügt werden, finden Sie unter Temporal.PlainDate.prototype.add()
.
Das Hinzufügen einer Dauer entspricht dem Subtrahieren ihrer Negation.
Beispiele
Eine Dauer hinzufügen
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()
.
Spezifikationen
Specification |
---|
Temporal proposal # sec-temporal.plaindatetime.prototype.add |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
add |
Legend
Tip: you can click/tap on a cell for more information.
- No support
- No support
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- User must explicitly enable this feature.