Temporal.PlainMonthDay.prototype.toPlainDate()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The toPlainDate() method of Temporal.PlainMonthDay instances returns a new Temporal.PlainDate object representing this month-day and a supplied year in the same calendar system.
Syntax
toPlainDate(yearInfo)
Parameters
yearInfo-
An object representing the year component of the resulting
PlainDate, containing the following properties (in the order they are retrieved and validated):eraanderaYear-
A string and an integer that correspond to the
eraanderaYearproperties. Are only used if the calendar system has eras.eraanderaYearmust be provided simultaneously. If they are not provided, thenyearmust be provided. If all ofera,eraYear, andyearare provided, they must be consistent. year-
Corresponds to the
yearproperty.
Return value
A new Temporal.PlainDate object representing the date specified by this month-day and the year in yearInfo, interpreted in the calendar system of this month-day.
Exceptions
RangeError-
Thrown if any of the options is invalid.
TypeError-
Thrown if
yearInfois not an object.
Examples
Using 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]
Specifications
| Specification |
|---|
| Temporal # sec-temporal.plainmonthday.prototype.toplaindate |
Browser compatibility
Loading…