Temporal.PlainDateTime()-Konstruktor
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 Temporal.PlainDateTime()-Konstruktor erstellt Temporal.PlainDateTime-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.PlainDateTime-Objekte in der Regel mit der statischen Methode Temporal.PlainDateTime.from() erstellen, die verschiedene Eingabetypen verarbeiten kann.
Syntax
new Temporal.PlainDateTime(year, month, day)
new Temporal.PlainDateTime(year, month, day, hour)
new Temporal.PlainDateTime(year, month, day, hour, minute)
new Temporal.PlainDateTime(year, month, day, hour, minute, second)
new Temporal.PlainDateTime(year, month, day, hour, minute, second, millisecond)
new Temporal.PlainDateTime(year, month, day, hour, minute, second, millisecond, microsecond)
new Temporal.PlainDateTime(year, month, day, hour, minute, second, millisecond, microsecond, nanosecond)
new Temporal.PlainDateTime(year, month, day, hour, minute, second, millisecond, microsecond, nanosecond, calendar)
Parameter
year-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und das Jahr im ISO-Kalendersystem angibt.
month-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und den Monat im ISO-Kalendersystem angibt.
day-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und den Tag des Monats im ISO-Kalendersystem angibt.
hourOptional-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und die Stundenkomponente angibt.
minuteOptional-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und die Minutenkomponente angibt.
secondOptional-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und die Sekundenkomponente angibt.
millisecondOptional-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und die Millisekundenkomponente angibt.
microsecondOptional-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und die Mikrosekundenkomponente angibt.
nanosecondOptional-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und die Nanosekundenkomponente angibt.
calendarOptional-
Eine Zeichenfolge, die den zu verwendenden Kalender angibt. Eine Liste häufig unterstützter Kalendertypen finden Sie unter
Intl.supportedValuesOf(). Der Standardwert ist"iso8601". Beachten Sie, dassyear,monthunddayunabhängig voncalendardem ISO-8601-Kalendersystem entsprechen müssen.
Rückgabewert
Ein neues Temporal.PlainDateTime-Objekt, das das durch die Parameter angegebene Datum und die Uhrzeit darstellt.
Ausnahmen
RangeError-
Wird in einem der folgenden Fälle ausgelöst:
- Eine Datums- oder Uhrzeitkomponente ist keine endliche Zahl.
- Die Kombination der Datums- und Uhrzeitkomponenten stellt kein gültiges Datum im ISO-Kalendersystem dar oder liegt außerhalb des darstellbaren Bereichs. Dieser umfasst ±(108 + 1) Tage beziehungsweise etwa ±273.972,6 Jahre relativ zur Unix-Epoche.
calendarist kein gültiger Kalenderbezeichner.
Beispiele
Temporal.PlainDateTime() verwenden
const dt = new Temporal.PlainDateTime(2021, 7, 1);
console.log(dt.toString()); // 2021-07-01T00:00:00
const dt2 = new Temporal.PlainDateTime(2021, 7, 1, 0, 0, 0, 0, 0, 0, "hebrew");
console.log(dt2.toString()); // 2021-07-01T00:00:00[u-ca=hebrew]
Spezifikationen
| Spezifikation |
|---|
| Temporal # sec-temporal-plaindatetime-constructor |