Konstruktor Temporal.PlainDateTime()
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.PlainDateTime() 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 normalerweise 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 darstellt.
month-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und den Monat im ISO-Kalendersystem darstellt.
day-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und den Tag des Monats im ISO-Kalendersystem darstellt.
hourOptional-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und die Stundenkomponente darstellt.
minuteOptional-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und die Minutenkomponente darstellt.
secondOptional-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und die Sekundenkomponente darstellt.
millisecondOptional-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und die Millisekundenkomponente darstellt.
microsecondOptional-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und die Mikrosekundenkomponente darstellt.
nanosecondOptional-
Eine Zahl, die auf eine Ganzzahl gekürzt wird und die Nanosekundenkomponente darstellt.
calendarOptional-
Eine Zeichenkette, die den zu verwendenden Kalender darstellt. Eine Liste häufig unterstützter Kalendertypen finden Sie unter
Intl.supportedValuesOf(). Der Standardwert ist"iso8601". Beachten Sie, dassyear,monthunddayunabhängig voncalendarim ISO-8601-Kalendersystem angegeben werden müssen.
Rückgabewert
Ein neues Temporal.PlainDateTime-Objekt, das das durch die Parameter angegebene Datum und die angegebene Uhrzeit darstellt.
Ausnahmen
RangeError-
Wird in einem der folgenden Fälle ausgelöst:
- Eine beliebige Datum-Uhrzeit-Komponente ist keine endliche Zahl.
- Die Kombination der Datum-Uhrzeit-Komponenten stellt kein gültiges Datum im ISO-Kalendersystem dar oder liegt nicht im darstellbaren Bereich, der ±(108 + 1) Tage bzw. etwa ±273.972,6 Jahre vom Unix-Epoch entfernt beträgt.
calendarist keine gültige Kalenderkennung.
Beispiele
Verwendung von Temporal.PlainDateTime()
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 |