Temporal.PlainDateTime.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.PlainDateTime-Instanzen gibt ein neues Temporal.PlainDateTime-Objekt zurück, das dieses Datum und diese Uhrzeit im neuen Kalendersystem darstellt. Da alle Temporal-Objekte als unveränderlich konzipiert sind, fungiert diese Methode im Wesentlichen als Setter für die calendarId-Eigenschaft der Datum-Uhrzeit.

Um die datumszeitlichen Komponenteneigenschaften zu ersetzen, verwenden Sie stattdessen die with()-Methode.

Syntax

js
withCalendar(calendar)

Parameter

calendar

Ein String, der der calendarId-Eigenschaft entspricht.

Rückgabewert

Ein neues Temporal.PlainDateTime-Objekt, das das durch den ursprünglichen PlainDateTime angegebene Datum und die Uhrzeit darstellt, 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()

js
const dt = Temporal.PlainDateTime.from("2021-07-01T12:34:56");
const newDT = dt.withCalendar("islamic");
console.log(newDT.toLocaleString("en-US", { calendar: "islamic" }));
// 11/21/1442 AH, 12:34:56 PM

Spezifikationen

Specification
Temporal proposal
# sec-temporal.plaindatetime.prototype.withcalendar

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch