Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 alle anderen Temporal-Klassen sollten Temporal.PlainDateTime-Objekte in der Regel mit der statischen Methode Temporal.PlainDateTime.from() konstruiert werden, die eine Vielzahl von Eingabetypen verarbeiten kann.

Syntax

js
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, ihn ohne new aufzurufen, führt zu einem TypeError.

Parameter

year

Eine Zahl, auf eine Ganzzahl gekürzt, die das Jahr im ISO-Kalendersystem darstellt.

month

Eine Zahl, auf eine Ganzzahl gekürzt, die den Monat im ISO-Kalendersystem darstellt.

day

Eine Zahl, auf eine Ganzzahl gekürzt, die den Tag des Monats im ISO-Kalendersystem darstellt.

hour Optional

Eine Zahl, auf eine Ganzzahl gekürzt, die die Stundenkomponente darstellt.

minute Optional

Eine Zahl, auf eine Ganzzahl gekürzt, die die Minutenkomponente darstellt.

second Optional

Eine Zahl, auf eine Ganzzahl gekürzt, die die Sekundenkomponente darstellt.

millisecond Optional

Eine Zahl, auf eine Ganzzahl gekürzt, die die Millisekundenkomponente darstellt.

microsecond Optional

Eine Zahl, auf eine Ganzzahl gekürzt, die die Mikrosekundenkomponente darstellt.

nanosecond Optional

Eine Zahl, auf eine Ganzzahl gekürzt, die die Nanosekundenkomponente darstellt.

calendar Optional

Ein String, der den Kalender angibt, der verwendet werden soll. Siehe Intl.supportedValuesOf() für eine Liste häufig unterstützter Kalendertypen. Standardmäßig ist es "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 spezifizierte Datum und die Uhrzeit darstellt.

Ausnahmen

RangeError

Wird in einem der folgenden Fälle ausgelöst:

  • Eine Datums- oder Zeitkomponente ist keine endliche Zahl.
  • Die Kombination der Komponenten stellt kein gültiges Datum im ISO-Kalendersystem dar oder liegt nicht im darstellbaren Bereich, der ±(108 + 1) Tage umfasst, das sind etwa ±273.972,6 Jahre ab der Unix-Epoche.
  • calendar ist keine gültige Kalenderkennung.

Beispiele

Verwendung von Temporal.PlainDateTime()

js
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

Browser-Kompatibilität

Siehe auch