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
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)
Parameter
yearsOptional-
Anzahl der Jahre oder
undefined(wird als0behandelt). monthsOptional-
Anzahl der Monate oder
undefined(wird als0behandelt). weeksOptional-
Anzahl der Wochen oder
undefined(wird als0behandelt). daysOptional-
Anzahl der Tage oder
undefined(wird als0behandelt). hoursOptional-
Anzahl der Stunden oder
undefined(wird als0behandelt). minutesOptional-
Anzahl der Minuten oder
undefined(wird als0behandelt). secondsOptional-
Anzahl der Sekunden oder
undefined(wird als0behandelt). millisecondsOptional-
Anzahl der Millisekunden oder
undefined(wird als0behandelt). microsecondsOptional-
Anzahl der Mikrosekunden oder
undefined(wird als0behandelt). nanosecondsOptional-
Anzahl der Nanosekunden oder
undefined(wird als0behandelt).
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()
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> |