Temporal.PlainDate.prototype.withCalendar()
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.
Die Methode withCalendar() von Temporal.PlainDate Instanzen gibt ein neues Temporal.PlainDate Objekt zurück, das dieses Datum im neuen Kalendersystem interpretiert. Da alle Temporal Objekte unveränderlich gestaltet sind, fungiert diese Methode im Wesentlichen als der Setter für die calendarId Eigenschaft des Datums.
Um die Datumsbestandteile zu ersetzen, verwenden Sie stattdessen die with() Methode.
Syntax
withCalendar(calendar)
Parameter
calendar-
Ein String, der der
calendarIdEigenschaft entspricht.
Rückgabewert
Ein neues Temporal.PlainDate Objekt, das das durch das ursprüngliche PlainDate angegebene Datum repräsentiert, interpretiert im neuen Kalendersystem.
Ausnahmen
TypeError-
Ausgelöst, wenn
calendarkein String ist. RangeError-
Ausgelöst, wenn
calendarkeine gültige Kalenderkennung ist.
Beispiele
Verwendung von withCalendar()
const date = Temporal.PlainDate.from("2021-07-01");
const newDate = date.withCalendar("islamic-umalqura");
console.log(newDate.toLocaleString("en-US", { calendar: "islamic-umalqura" }));
// 11/21/1442 AH
Spezifikationen
| Specification |
|---|
| Temporal proposal # sec-temporal.plaindate.prototype.withcalendar |