Temporal.Duration.prototype.add()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die add()-Methode von Temporal.Duration-Instanzen gibt ein neues Temporal.Duration-Objekt mit der Summe dieser Dauer und einer gegebenen Dauer zurück. Das Ergebnis ist ausgeglichen.
Syntax
add(other)
Parameter
other-
Ein String, ein Objekt oder eine
Temporal.Duration-Instanz, die eine hinzuzufügende Dauer darstellt. Sie wird unter Verwendung desselben Algorithmus wieTemporal.Duration.from()in einTemporal.Duration-Objekt umgewandelt.
Rückgabewert
Ein neues Temporal.Duration-Objekt, das die Summe dieser Dauer und von other darstellt.
Ausnahmen
RangeError-
Wird in einem der folgenden Fälle ausgelöst:
- Entweder
thisoderotherist eine Kalenderdauer (sie hat ein nicht-nullyears,monthsoderweeks), da Kalenderdauern ohne einen Kalender und eine Zeitreferenz mehrdeutig sind. - Die Summe von
thisundotherüberschreitet die maximal darstellbare Dauer oder unterschreitet die minimal darstellbare Dauer, welche ±253 Sekunden beträgt.
- Entweder
Beschreibung
Nicht-Kalender-Dauern repräsentieren unmissverständlich einen festen Zeitraum. Intern werden this und other beide in Nanosekunden umgerechnet (unter der Annahme von 24-Stunden-Tagen) und zusammengefügt. Das Ergebnis wird dann in ein Temporal.Duration-Objekt zurückkonvertiert, sodass das Ergebnis immer ausgeglichen oder unausgeglichen 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 gleichwertig 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 |