Temporal.PlainDate()
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.PlainDate() Konstruktor erstellt Temporal.PlainDate Objekte.
Dieser Konstruktor ermöglicht es Ihnen, Instanzen direkt durch die Angabe der zugrunde liegenden Daten zu erstellen. Wie alle anderen Temporal Klassen sollten Temporal.PlainDate Objekte in der Regel mit der statischen Methode Temporal.PlainDate.from() konstruiert werden, welche 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 auf eine ganze Zahl gekürzt wird, welche das Jahr im ISO-Kalendersystem darstellt.
month-
Eine Zahl, die auf eine ganze Zahl gekürzt wird, welche den Monat im ISO-Kalendersystem darstellt.
day-
Eine Zahl, die auf eine ganze Zahl gekürzt wird, welche den Tag des Monats im ISO-Kalendersystem darstellt.
calendarOptional-
Ein String, der den Kalender darstellt, der verwendet werden soll. Siehe
Intl.supportedValuesOf()für eine Liste der allgemein unterstützten Kalendertypen. Standardmäßig"iso8601". Beachten Sie, dass unabhängig vomcalendar,year,monthunddayim ISO 8601 Kalendersystem sein müssen.
Rückgabewert
Ein neues Temporal.PlainDate Objekt, das das durch year, month, day (im ISO-Kalender) spezifizierte Datum repräsentiert, interpretiert im Kalendersystem, das durch calendar angegeben ist.
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 von
year,monthunddaystellt kein gültiges Datum im ISO-Kalendersystem dar oder befindet sich nicht im darstellbaren Bereich, welcher ±(108 + 1) Tage, oder etwa ±273.972,6 Jahre, ab dem Unix-Epoch umfasst. 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
| Specification |
|---|
| Temporal # sec-temporal-plaindate-constructor |