Temporal.ZonedDateTime.prototype.withCalendar()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die withCalendar() Methode von Temporal.ZonedDateTime Instanzen gibt ein neues Temporal.ZonedDateTime Objekt zurück, das dieses Datum-Uhrzeit in dem neuen Kalendersystem interpretiert. Da alle Temporal Objekte unveränderlich gestaltet sind, fungiert diese Methode im Wesentlichen als Setter für die calendarId Eigenschaft der Datum-Uhrzeit.
Um die Eigenschaftskomponenten der Datum-Uhrzeit zu ersetzen, verwenden Sie die with() Methode. Um die Zeitzone zu ersetzen, verwenden Sie die withTimeZone() Methode.
Syntax
withCalendar(calendar)
Parameter
calendar-
Ein String, der der
calendarIdEigenschaft entspricht. SieheIntl.supportedValuesOf()für eine Liste der allgemein unterstützten Kalendertypen.
Rückgabewert
Ein neues Temporal.ZonedDateTime Objekt, das die in dem originalen ZonedDateTime spezifizierte Datum-Uhrzeit darstellt, interpretiert im neuen Kalendersystem.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
calendarkein String ist. RangeError-
Wird ausgelöst, wenn
calendarkein gültiger Kalender-Identifikator ist.
Beispiele
Verwendung von withCalendar()
const zdt = Temporal.ZonedDateTime.from(
"2021-07-01T12:34:56[America/New_York]",
);
const newZDT = zdt.withCalendar("islamic-umalqura");
console.log(newZDT.toLocaleString("en-US", { calendar: "islamic-umalqura" }));
// 11/21/1442 AH, 12:34:56 PM EDT
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.zoneddatetime.prototype.withcalendar |