Temporal.PlainDateTime.prototype.withCalendar()

Базовая функциональность Ограниченная доступность

Эта функция не является базовой, поскольку она не работает в некоторых из наиболее широко используемых браузеров.

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

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

Синтаксис

withCalendar(calendar)

Параметры

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

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

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

Исключения

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

Примеры

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

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

Спецификация
Temporal # sec-temporal.plaindatetime.prototype.withcalendar

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

	Десктопные					Мобильные							Серверные
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS	Bun	Deno	Node.js
`withCalendar`	144	144	139 Календари `islamic`, `islamic-rgsa` и `islamic-umalqura` недоступны. См. ошибку 1950425 и ошибку 1954138.	128	preview	144	139 Календари `islamic`, `islamic-rgsa` и `islamic-umalqura` недоступны. См. ошибку 1950425 и ошибку 1954138.	95	No	No	144	No	1.4.0	2.7	26.0.0

См. также

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Temporal/PlainDateTime/withCalendar