Temporal.Instant.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.Instant-Instanzen gibt ein neues Temporal.Instant-Objekt zurück, das diesen Zeitpunkt um eine gegebene Dauer vorwärts bewegt darstellt (in einer Form, die durch Temporal.Duration.from() umgewandelt werden kann).

In diesem Artikel

Syntax

add(duration)

Parameter

duration

Ein String, ein Objekt oder eine Temporal.Duration-Instanz, die eine Dauer darstellt, die zu diesem Zeitpunkt hinzugefügt werden soll. Diese wird mit demselben Algorithmus wie Temporal.Duration.from() in ein Temporal.Duration-Objekt umgewandelt.

Rückgabewert

Ein neues Temporal.Instant-Objekt, das die Addition der duration zu diesem Zeitpunkt darstellt. Ist duration positiv, ist der zurückgegebene Zeitpunkt später als dieser Zeitpunkt; ist duration negativ, ist der zurückgegebene Zeitpunkt früher als dieser Zeitpunkt.

Ausnahmen

RangeError

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

duration ist eine Kalenderdauer (hat einen ungleich null years, months oder weeks), oder hat ungleich null days, da Kalenderdauern ohne Kalender- und Zeitbezug mehrdeutig sind.
Das Ergebnis liegt nicht im darstellbaren Bereich, der bei ±108 Tagen oder etwa ±273,972.6 Jahren vom Unix-Epoch liegt.

Beschreibung

Im Wesentlichen ermittelt die add()-Methode zuerst die Anzahl der Nanosekunden, die duration darstellt, fügt diese den epochNanoseconds dieses Zeitpunktes hinzu und erstellt dann ein neues Temporal.Instant-Objekt aus dem Ergebnis. Daher muss die Dauer eindeutig eine feste Zeitmenge darstellen.

Wenn Sie eine Kalenderdauer hinzufügen möchten, muss die Addition im Kontext eines Kalenders und einer Zeitzone erfolgen, um die variablen Längen von Monaten, Jahren und Tagen (aufgrund von Sommerzeit) zu berücksichtigen. In diesem Fall konvertieren Sie den Zeitpunkt in ein Temporal.ZonedDateTime-Objekt, fügen die Dauer hinzu und konvertieren das Ergebnis dann zurück in einen Zeitpunkt.

Das Hinzufügen einer Dauer entspricht dem Subtrahieren ihrer Negation.

Beispiele

Hinzufügen einer Temporal.Duration

js
const instant = Temporal.Instant.fromEpochMilliseconds(0);
const duration = Temporal.Duration.from("PT1S");
const newInstant = instant.add(duration);
console.log(newInstant.epochMilliseconds); // 1000

Hinzufügen eines Objekts oder eines Strings

js
const instant = Temporal.Instant.fromEpochMilliseconds(0);
const newInstant = instant.add({ seconds: 1 });
console.log(newInstant.epochMilliseconds); // 1000

const newInstant2 = instant.add("PT1S");
console.log(newInstant2.epochMilliseconds); // 1000

Hinzufügen einer Kalenderdauer

js
const instant = Temporal.Instant.fromEpochMilliseconds(1730610000000);
const duration = Temporal.Duration.from({ days: 1 });

// This instant is 2024-11-03T01:00:00-04:00[America/New_York],
// which is a DST transition day in the US.
const instant2 = instant
  .toZonedDateTimeISO("America/New_York")
  .add(duration)
  .toInstant();
console.log(instant2.epochMilliseconds); // 1730700000000

// The same instant is not a DST transition day in Paris.
const instant3 = instant
  .toZonedDateTimeISO("Europe/Paris")
  .add(duration)
  .toInstant();
console.log(instant3.epochMilliseconds); // 1730696400000

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.Instant
Konstruktor
1. Temporal.Instant()
Statische Methoden
1. compare()
2. from()
3. fromEpochMilliseconds()
4. fromEpochNanoseconds()
Instanzmethoden
1. add()
2. equals()
3. round()
4. since()
5. subtract()
6. toJSON()
7. toLocaleString()
8. toString()
9. toZonedDateTimeISO()
10. until()
11. valueOf()
Instanzeigenschaften
1. epochMilliseconds
2. epochNanoseconds
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.Duration
Temporal.Now
Temporal.PlainDate
Temporal.PlainDateTime
Temporal.PlainMonthDay
Temporal.PlainTime
Temporal.PlainYearMonth
Temporal.ZonedDateTime