Temporal.PlainDate.prototype.withCalendar()

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

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

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

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

Синтаксис

withCalendar(calendar)

Параметры

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

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

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

Исключения

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

Примеры

Использование withCalendar()

const date = Temporal.PlainDate.from("2021-07-01");
const newDate = date.withCalendar("islamic-umalqura");
console.log(newDate.toLocaleString("en-US", { calendar: "islamic-umalqura" }));
// 11/21/1442 AH

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

Спецификация
Temporal # sec-temporal.plaindate.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` недоступны. См. bug 1950425 и bug 1954138.	128	preview	144	139 Календари `islamic`, `islamic-rgsa` и `islamic-umalqura` недоступны. См. bug 1950425 и bug 1954138.	95	Нет	Нет	144	Нет	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/PlainDate/withCalendar