Temporal.PlainDateTime.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.PlainDateTime Instanzen gibt ein neues Temporal.PlainDateTime Objekt zurück, das diesen Datum-Uhrzeit-Wert im neuen Kalendersystem interpretiert darstellt. 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 Datum-Uhrzeit-Wertes.
Um die Eigenschaften der Datum-Uhrzeit-Komponente zu ersetzen, verwenden Sie stattdessen die with() Methode.
Syntax
withCalendar(calendar)
Parameter
calendar-
Ein String, der der
calendarIdEigenschaft entspricht. SieheIntl.supportedValuesOf()für eine Liste der häufig unterstützten Kalendertypen.
Rückgabewert
Ein neues Temporal.PlainDateTime Objekt, das das von der ursprünglichen PlainDateTime angegebene Datum-Uhrzeit-Wert darstellt, interpretiert im neuen Kalendersystem.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
calendarkein String ist. RangeError-
Wird ausgelöst, wenn
calendarkeine gültige Kalenderkennung ist.
Beispiele
Verwendung von withCalendar()
const dt = Temporal.PlainDateTime.from("2021-07-01T12:34:56");
const newDT = dt.withCalendar("islamic-umalqura");
console.log(newDT.toLocaleString("en-US", { calendar: "islamic-umalqura" }));
// 11/21/1442 AH, 12:34:56 PM
Spezifikationen
| Spezifikation |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.withcalendar |