Konstruktor Temporal.PlainDate()
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.PlainDate() erstellt Temporal.PlainDate-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.PlainDate-Objekte üblicherweise mit der statischen Methode Temporal.PlainDate.from() erstellen, die eine Vielzahl von Eingabetypen verarbeiten kann.
Syntax
new Temporal.PlainDate(year, month, day)
new Temporal.PlainDate(year, month, day, 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.
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 angegeben werden müssen.
Rückgabewert
Ein neues Temporal.PlainDate-Objekt, das das durch year, month und day (im ISO-Kalender) angegebene Datum darstellt und im durch calendar angegebenen Kalendersystem interpretiert wird.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
calendarkein String oderundefinedist. 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 nicht im darstellbaren Bereich, der ±(108 + 1) Tage beziehungsweise etwa ±273.972,6 Jahre von der Unix-Epoche beträgt. calendarist kein gültiger Kalenderbezeichner.
Beispiele
Verwendung von Temporal.PlainDate()
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 |