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 withCalendar() Methode von Temporal.PlainDate Instanzen gibt ein neues Temporal.PlainDate Objekt zurück, das dieses Datum im neuen Kalendersystem interpretiert darstellt. Da alle Temporal Objekte unveränderlich gestaltet sind, fungiert diese Methode im Wesentlichen als Setter für die calendarId Eigenschaft des Datums.
Um die Datumskomponenten-Eigenschaften zu ersetzen, verwenden Sie stattdessen die with() Methode.
Syntax
withCalendar(calendar)
Parameter
calendar-
Ein String, der der
calendarIdEigenschaft entspricht. SieheIntl.supportedValuesOf()für eine Liste der häufig unterstützten Kalendertypen.
Rückgabewert
Ein neues Temporal.PlainDate Objekt, das das ursprüngliche PlainDate Datum im neuen Kalendersystem interpretiert darstellt.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
calendarkein String ist. RangeError-
Wird ausgelöst, wenn
calendarkein gültiger Kalender-Identifier 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 # sec-temporal.plaindate.prototype.withcalendar |
Browser-Kompatibilität
Loading…