Temporal.Duration.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.Duration-Instanzen gibt ein neues Temporal.Duration-Objekt zurück, das die Summe dieser Dauer und einer gegebenen Dauer darstellt. Das Ergebnis ist ausbalanciert.

Syntax

add(other)

Parameter

other: Ein String, ein Objekt oder eine Temporal.Duration-Instanz, die eine Dauer darstellt, die zu dieser Dauer hinzugefügt werden soll. Es wird zu einem Temporal.Duration-Objekt umgewandelt, indem derselbe Algorithmus wie bei Temporal.Duration.from() verwendet wird.

Rückgabewert

Ein neues Temporal.Duration-Objekt, das die Summe dieser Dauer und other darstellt.

Ausnahmen

RangeError

Wird in einem der folgenden Fälle ausgelöst:

Entweder this oder other ist eine Kalenderdauer (sie hat ein nicht-null years, months oder weeks), da Kalenderdauern ohne einen Kalender und Zeitreferenz mehrdeutig sind.
Die Summe von this und other überschreitet die maximal oder unterschreitet die minimal darstellbare Dauer, die ±2⁵³ Sekunden beträgt.

Beschreibung

Nicht-Kalender-Dauern stellen unmissverständlich eine feste Zeitspanne dar. Intern werden this und other beide in Nanosekunden umgewandelt (bei Annahme von 24-Stunden-Tagen) und zusammengezählt. Das Ergebnis wird dann zurück in ein Temporal.Duration-Objekt umgewandelt, sodass das Ergebnis immer ausbalanciert oder kopflastig ist, wobei die größte mögliche Einheit days ist.

Wenn Sie eine Addition oder Subtraktion mit einer Kalenderdauer durchführen möchten, können Sie beide Dauern zu einem Startpunkt hinzufügen und dann die Differenz zwischen den beiden resultierenden Zeitpunkten ermitteln; das heißt, dur1 + dur2 ist äquivalent zu (start + dur1 + dur2) - start.

Um eine Dauer zu einem Datum oder einer Uhrzeit hinzuzufügen, verwenden Sie stattdessen die add()-Methode des Datums- oder Zeitobjekts.

Beispiele

Verwendung von add()

const d1 = Temporal.Duration.from({ hours: 1, minutes: 30 });
const d2 = Temporal.Duration.from({ hours: -1, minutes: -20 });

const d3 = d1.add(d2);
console.log(d3.toString()); // "PT10M"

Hinzufügen von Kalenderdauern

const d1 = Temporal.Duration.from({ days: 1 });
const d2 = Temporal.Duration.from({ months: 1 });

d1.add(d2); // RangeError: for calendar duration arithmetic, use date arithmetic relative to a starting point

const start = Temporal.PlainDateTime.from("2022-01-01T00:00"); // ISO 8601 calendar
const result = start.add(d1).add(d2).since(start);
console.log(result.toString()); // "P32D"

Spezifikationen

Specification
Temporal # sec-temporal.duration.prototype.add