Temporal.PlainDateTime.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.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
| Specification |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.withcalendar |