Temporal.PlainMonthDay.prototype.toPlainDate()

Метод toPlainDate() экземпляров Temporal.PlainMonthDay возвращает новый объект Temporal.PlainDate, представляющий этот месяц-день и предоставленный год в той же календарной системе.

Синтаксис

toPlainDate(yearInfo)

Параметры

yearInfo

Объект, представляющий компонент года результирующего PlainDate, содержащий следующие свойства (в порядке их извлечения и проверки):

era и eraYear

Строка и целое число, которые соответствуют свойствам era и eraYear. Используются только в том случае, если календарная система имеет эры. era и eraYear должны быть предоставлены одновременно. Если они не предоставлены, то должен быть предоставлен year. Если предоставлены все era, eraYear и year, они должны быть согласованы.

year

Соответствует свойству year.

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

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

Исключения

RangeError

Выбрасывается, если какой-либо из параметров неверен.

TypeError

Выбрасывается, если yearInfo не является объектом.

Примеры

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

const md = Temporal.PlainMonthDay.from("07-01");
const date = md.toPlainDate({ year: 2021 });
console.log(date.toString()); // 2021-07-01

const md2 = Temporal.PlainMonthDay.from("2021-07-01[u-ca=japanese]");
const date2 = md2.toPlainDate({ era: "reiwa", eraYear: 1 });
console.log(date2.toString()); // 2019-07-01[u-ca=japanese]

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

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

См. также

• Temporal.PlainMonthDay
• Temporal.PlainDate
• Temporal.PlainDate.prototype.toPlainMonthDay()