Temporal.PlainDate()-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 Konstruktor Temporal.PlainDate() erstellt Temporal.PlainDate-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.PlainDate-Objekte normalerweise mit der statischen Methode Temporal.PlainDate.from() erstellen, die verschiedene Eingabetypen verarbeiten kann.
Syntax
new Temporal.PlainDate(year, month, day)
new Temporal.PlainDate(year, month, day, 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.
calendarOptional-
Ein String, der den zu verwendenden Kalender angibt. Eine Liste häufig unterstützter Kalendertypen finden Sie unter
Intl.supportedValuesOf(). Der Standardwert ist"iso8601". Unabhängig voncalendarmüssenyear,monthunddayim ISO-8601-Kalendersystem angegeben werden.
Rückgabewert
Ein neues Temporal.PlainDate-Objekt, das das durch year, month und day angegebene Datum (im ISO-Kalender) repräsentiert, interpretiert im durch calendar angegebenen Kalendersystem.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
calendarweder ein String nochundefinedist. RangeError-
Wird in einem der folgenden Fälle ausgelöst:
year,monthoderdayist keine endliche Zahl.- Die Kombination aus
year,monthunddaystellt 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 ab der Unix-Epoche. calendarist kein gültiger Kalenderbezeichner.
Beispiele
Temporal.PlainDate() verwenden
const plainDate = new Temporal.PlainDate(2021, 7, 1);
console.log(plainDate.toString()); // 2021-07-01
// Note that the date is stored internally as ISO 8601, even when it's
// interpreted in a different calendar system. For example, even though
// 2021-07-01 ISO is 5781-10-21 in the Hebrew calendar, you still pass the
// ISO date to the constructor.
const plainDate2 = new Temporal.PlainDate(2021, 7, 1, "hebrew");
console.log(plainDate2.toString()); // 2021-07-01[u-ca=hebrew]
console.log(plainDate2.year); // 5781
console.log(plainDate2.month); // 10
console.log(plainDate2.day); // 21
Spezifikationen
| Spezifikation |
|---|
| Temporal # sec-temporal-plaindate-constructor |