Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Konstruktor Temporal.Duration()

Eingeschränkt verfügbar

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

Want more browser support for this feature? Tell us why.

Der Konstruktor Temporal.Duration() erstellt Temporal.Duration-Objekte.

Mit diesem Konstruktor können Sie Instanzen erstellen, indem Sie die zugrunde liegenden Daten direkt angeben. Wie bei allen anderen Temporal-Klassen sollten Sie Temporal.Duration-Objekte in der Regel mit der statischen Methode Temporal.Duration.from() erstellen, die verschiedene Eingabetypen verarbeiten kann.

Syntax

js
new Temporal.Duration()
new Temporal.Duration(years)
new Temporal.Duration(years, months)
new Temporal.Duration(years, months, weeks)
new Temporal.Duration(years, months, weeks, days)
new Temporal.Duration(years, months, weeks, days, hours)
new Temporal.Duration(years, months, weeks, days, hours, minutes)
new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds)
new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds, milliseconds)
new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds)
new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds)

Hinweis: Temporal.Duration() kann nur mit new konstruiert werden. Der Versuch, es ohne new aufzurufen, löst einen TypeError aus.

Parameter

years Optional

Anzahl der Jahre oder undefined (wird als 0 behandelt).

months Optional

Anzahl der Monate oder undefined (wird als 0 behandelt).

weeks Optional

Anzahl der Wochen oder undefined (wird als 0 behandelt).

days Optional

Anzahl der Tage oder undefined (wird als 0 behandelt).

hours Optional

Anzahl der Stunden oder undefined (wird als 0 behandelt).

minutes Optional

Anzahl der Minuten oder undefined (wird als 0 behandelt).

seconds Optional

Anzahl der Sekunden oder undefined (wird als 0 behandelt).

milliseconds Optional

Anzahl der Millisekunden oder undefined (wird als 0 behandelt).

microseconds Optional

Anzahl der Mikrosekunden oder undefined (wird als 0 behandelt).

nanoseconds Optional

Anzahl der Nanosekunden oder undefined (wird als 0 behandelt).

Rückgabewert

Ein neues Temporal.Duration-Objekt, möglicherweise unausgeglichen, mit den angegebenen Komponenten.

Ausnahmen

RangeError

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

  • Einer der Parameter ist keine Ganzzahl (einschließlich nicht endlicher Werte).
  • Eine Kalendereinheit (Jahre, Monate, Wochen) hat einen Absolutwert ≥ 232.
  • Der Nicht-Kalenderteil der Dauer (Tage und kleinere Einheiten) hat, in Sekunden ausgedrückt, einen Absolutwert ≥ 253.

Beispiele

Verwendung von Temporal.Duration()

js
const d = new Temporal.Duration(1, 2, 3, 4, 5, 6, 7, 8, 9, 10);
console.log(d.toString()); // "P1Y2M3W4DT5H6M7.00800901S"

Spezifikationen

Spezifikation
Temporal
# sec-temporal-duration-constructor

Browser-Kompatibilität

Siehe auch