Temporal.ZonedDateTime.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.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
| Spezifikation |
|---|
| Temporal # sec-temporal.zoneddatetime.prototype.withcalendar |