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. 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 Datumsbestandteile zu ersetzen, verwenden Sie stattdessen die with()-Methode.

Syntax

withCalendar(calendar)

Parameter

calendar: Ein String, der der calendarId-Eigenschaft entspricht. Siehe Intl.supportedValuesOf() für eine Liste der häufig unterstützten Kalenderarten.

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 calendar kein String ist.
RangeError: Wird ausgelöst, wenn calendar kein 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

Specification
Temporal # sec-temporal.plaindate.prototype.withcalendar