Temporal.ZonedDateTime.prototype.withCalendar()

withCalendar() метод экземпляров Temporal.ZonedDateTime возвращает новый объект Temporal.ZonedDateTime, представляющий эту дату-время, интерпретированную в новой системе календаря. Поскольку все объекты Temporal разработаны как неизменяемые, этот метод по сути функционирует как сеттер для свойства calendarId даты-времени.

Чтобы заменить свойства компонента даты-времени, используйте метод with(). Чтобы заменить его часовой пояс, используйте метод withTimeZone().

Синтаксис

withCalendar(calendar)

Параметры

calendar

Строка, соответствующая свойству calendarId. См. Intl.supportedValuesOf() список часто поддерживаемых типов календарей.

Возвращаемое значение

Новый объект Temporal.ZonedDateTime, представляющий дату-время, указанную исходным ZonedDateTime, интерпретированную в новой системе календаря.

Исключения

TypeError

Выбрасывается, если calendar не является строкой.

RangeError

Выбрасывается, если calendar не является допустимым идентификатором календаря.

Примеры

Использование 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

Спецификации

Совместимость с браузерами

См. также

• Temporal.ZonedDateTime
• Temporal.ZonedDateTime.prototype.with()
• Temporal.ZonedDateTime.prototype.withTimeZone()
• Temporal.ZonedDateTime.prototype.withPlainTime()
• Temporal.ZonedDateTime.from()
• Temporal.ZonedDateTime.prototype.calendarId