Temporal.Duration.prototype.add()

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

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.

In diesem Artikel

Ein String, ein Objekt oder eine Temporal.Duration-Instanz, die eine hinzuzufügende Dauer darstellt. Sie wird unter Verwendung desselben Algorithmus wie Temporal.Duration.from() in ein Temporal.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 this oder other ist eine Kalenderdauer (sie hat ein nicht-null years, months oder weeks), da Kalenderdauern ohne einen Kalender und eine Zeitreferenz mehrdeutig sind.
Die Summe von this und other überschreitet die maximal darstellbare Dauer oder unterschreitet die minimal darstellbare Dauer, welche ±253 Sekunden beträgt.

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()

js
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

js
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"

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Temporal.Duration
Konstruktor
1. Temporal.Duration()
Statische Methoden
1. compare()
2. from()
Instanzmethoden
1. abs()
2. add()
3. negated()
4. round()
5. subtract()
6. toJSON()
7. toLocaleString()
8. toString()
9. total()
10. valueOf()
11. with()
Instanzeigenschaften
1. blank
2. days
3. hours
4. microseconds
5. milliseconds
6. minutes
7. months
8. nanoseconds
9. seconds
10. sign
11. weeks
12. years
Vererbung
Object/Function
Statische Methoden
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Statische Eigenschaften
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Instanzmethoden
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
Instanzeigenschaften
1. __proto__
2. constructor
Verwandte Seiten
Temporal
Temporal.Instant
Temporal.Now
Temporal.PlainDate
Temporal.PlainDateTime
Temporal.PlainMonthDay
Temporal.PlainTime
Temporal.PlainYearMonth
Temporal.ZonedDateTime

Temporal.Duration.prototype.add()

In diesem Artikel

Syntax

Parameter