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 angegebenen Dauer darstellt. Das Ergebnis wird ausgeglichen.
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 mit demselben Algorithmus wieTemporal.Duration.from()
in einTemporal.Duration
-Objekt konvertiert.
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:
this
oderother
ist eine Kalenderdauer (sie enthält einen Wert ungleich null füryears
,months
oderweeks
), da Kalenderdauern ohne Kalender und Zeitreferenz mehrdeutig sind.- Die Summe von
this
undother
überschreitet die maximal darstellbare Dauer oder unterschreitet die minimal darstellbare Dauer, was ±253 Sekunden sind.
Beschreibung
Nicht-Kalender-Dauern stellen eine feste Zeitspanne eindeutig dar. Intern werden this
und other
beide in Nanosekunden konvertiert (unter der Annahme, dass Tage 24 Stunden lang sind) und zusammengezählt. Das Ergebnis wird dann zurück in ein Temporal.Duration
-Objekt konvertiert, sodass das Ergebnis stets ausgeglichen oder feldübergreifend 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 Ausgangspunkt hinzufügen und dann die Differenz zwischen den beiden resultierenden Zeitpunkten ermitteln; das bedeutet, dur1 + dur2
entspricht (start + dur1 + dur2) - start
.
Um eine Dauer zu einem Datum oder einer Zeit hinzuzufügen, verwenden Sie die Methode add()
des jeweiligen 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 proposal # sec-temporal.duration.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.