Temporal.PlainDateTime()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Der Temporal.PlainDateTime() Konstruktor erstellt Temporal.PlainDateTime Objekte.

Dieser Konstruktor ermöglicht es Ihnen, Instanzen durch direkte Angabe der zugrunde liegenden Daten zu erstellen. Wie bei allen anderen Temporal-Klassen sollten Sie Temporal.PlainDateTime-Objekte normalerweise mit der statischen Methode Temporal.PlainDateTime.from() erstellen, die eine Vielzahl von 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)

Hinweis:>Temporal.PlainDateTime() kann nur mit new konstruiert werden. Der Versuch, es ohne new aufzurufen, führt zu einem TypeError.

Parameter

year: Eine Zahl, als ganze Zahl abgeschnitten, die das Jahr im ISO-Kalendersystem darstellt.
month: Eine Zahl, als ganze Zahl abgeschnitten, die den Monat im ISO-Kalendersystem darstellt.
day: Eine Zahl, als ganze Zahl abgeschnitten, die den Tag des Monats im ISO-Kalendersystem darstellt.
hour Optional: Eine Zahl, als ganze Zahl abgeschnitten, die die Stundenkomponente darstellt.
minute Optional: Eine Zahl, als ganze Zahl abgeschnitten, die die Minutenkomponente darstellt.
second Optional: Eine Zahl, als ganze Zahl abgeschnitten, die die Sekundenkomponente darstellt.
millisecond Optional: Eine Zahl, als ganze Zahl abgeschnitten, die die Millisekundenkomponente darstellt.
microsecond Optional: Eine Zahl, als ganze Zahl abgeschnitten, die die Mikrosekundenkomponente darstellt.
nanosecond Optional: Eine Zahl, als ganze Zahl abgeschnitten, die die Nanosekundenkomponente darstellt.
calendar Optional: Ein String, der den zu verwendenden Kalender darstellt. Siehe Intl.supportedValuesOf() für eine Liste der allgemein unterstützten Kalendertypen. Standard ist "iso8601". Beachten Sie, dass unabhängig vom calendar die year, month und day im ISO 8601-Kalendersystem sein 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 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 ±(10⁸ + 1) Tage oder etwa ±273.972,6 Jahre vom Unix-Epoch umfasst.
calendar ist kein gültiger Kalenderbezeichner.

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

Specification
Temporal # sec-temporal-plaindatetime-constructor