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

View in English Always switch to English

Temporal.Duration()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Dieser Konstruktor ermöglicht es Ihnen, Instanzen direkt durch die Angabe der zugrunde liegenden Daten zu erstellen. Wie bei allen anderen Temporal-Klassen sollten Sie Temporal.Duration-Objekte normalerweise mit der Temporal.Duration.from() statischen Methode erstellen, die eine Vielzahl von 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, führt zu einem TypeError.

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 kalenderbezogene Teil der Dauer (Tage und darunter), ausgedrückt in Sekunden, hat 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

Specification
Temporal
# sec-temporal-duration-constructor

Browser-Kompatibilität

Siehe auch