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.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
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 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 zu einer Ganzzahl gekürzt wird und das Jahr im ISO-Kalendersystem darstellt.
month-
Eine Zahl, die zu einer Ganzzahl gekürzt wird und den Monat im ISO-Kalendersystem darstellt.
day-
Eine Zahl, die zu einer Ganzzahl gekürzt wird und den Tag des Monats im ISO-Kalendersystem darstellt.
hourOptional-
Eine Zahl, die zu einer Ganzzahl gekürzt wird und die Stundenkomponente darstellt.
minuteOptional-
Eine Zahl, die zu einer Ganzzahl gekürzt wird und die Minutenkomponente darstellt.
secondOptional-
Eine Zahl, die zu einer Ganzzahl gekürzt wird und die Sekundenkomponente darstellt.
millisecondOptional-
Eine Zahl, die zu einer Ganzzahl gekürzt wird und die Millisekundenkomponente darstellt.
microsecondOptional-
Eine Zahl, die zu einer Ganzzahl gekürzt wird und die Mikrosekundenkomponente darstellt.
nanosecondOptional-
Eine Zahl, die zu einer Ganzzahl gekürzt wird und die Nanosekundenkomponente darstellt.
calendarOptional-
Ein String, der 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 liegen müssen.
Rückgabewert
Ein neues Temporal.PlainDateTime-Objekt, das das durch die Parameter angegebene Datum mit Uhrzeit darstellt.
Ausnahmen
RangeError-
Wird in einem der folgenden Fälle ausgelöst:
- Eine 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. Dieser beträgt ±(108 + 1) Tage beziehungsweise etwa ±273.972,6 Jahre ab der Unix-Epoche.
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 |