Temporal.Duration()

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.

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

Dieser Konstruktor ermöglicht es Ihnen, Instanzen zu erstellen, indem Sie die zugrunde liegenden Daten direkt bereitstellen. Wie bei allen anderen Temporal-Klassen sollten Temporal.Duration-Objekte normalerweise mit der statischen Methode Temporal.Duration.from() konstruiert werden, die mit einer Vielzahl von Eingabetypen umgehen kann.

Syntax

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. Ein Versuch, dies ohne new aufzurufen, wirft einen 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 unbalanced, mit den angegebenen Komponenten.

Ausnahmen

RangeError

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

Einer der Parameter ist keine ganze Zahl (einschließlich nicht-finite Werte).
Eine Kalendereinheit (Jahre, Monate, Wochen) hat einen absoluten Wert ≥ 2³².
Der nicht-Kalender-Teil der Dauer (Tage und darunter), ausgedrückt in Sekunden, hat einen absoluten Wert ≥ 2⁵³.

Beispiele

Verwendung von Temporal.Duration()

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

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

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