Temporal.PlainDate.prototype.withCalendar()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Die withCalendar()-Methode von Temporal.PlainDate-Instanzen gibt ein neues Temporal.PlainDate-Objekt zurück, das dieses Datum im neuen Kalendersystem interpretiert. Da alle Temporal-Objekte so konzipiert sind, dass sie unveränderlich sind, fungiert diese Methode im Wesentlichen als Setter für die calendarId-Eigenschaft des Datums.
Um die Datumskomponenteneigenschaften zu ersetzen, verwenden Sie stattdessen die with()-Methode.
Syntax
withCalendar(calendar)
Parameter
calendar-
Ein String, der der
calendarId-Eigenschaft entspricht. SieheIntl.supportedValuesOf()für eine Liste häufig unterstützter Kalendertypen.
Rückgabewert
Ein neues Temporal.PlainDate-Objekt, das das Datum repräsentiert, das durch das ursprüngliche PlainDate angegeben wird, interpretiert im neuen Kalendersystem.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
calendarkein String ist. RangeError-
Wird ausgelöst, wenn
calendarkein gültiger Kalenderbezeichner 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
| Spezifikation |
|---|
| Temporal # sec-temporal.plaindate.prototype.withcalendar |