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
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 kalenderbezogene Teil der Dauer (Tage und darunter), ausgedrückt in Sekunden, hat 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
| Specification |
|---|
| Temporal> # sec-temporal-duration-constructor> |