Temporal.PlainYearMonth.prototype.toPlainDate()

Baseline Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The toPlainDate() method of Temporal.PlainYearMonth instances returns a new Temporal.PlainDate object representing this year-month and a supplied day in the same calendar system.

Syntax

toPlainDate(dayInfo)

Parameters

dayInfo Optional

An object representing the day component of the resulting PlainDate, containing the following property:

day: Corresponds to the day property.

Return value

A new Temporal.PlainDate object representing the date specified by this year-month and the day in dayInfo, interpreted in the calendar system of this year-month.

Exceptions

RangeError: Thrown if any of the options is invalid.
TypeError: Thrown if dayInfo is not an object.

Examples

Using toPlainDate()

const ym = Temporal.PlainYearMonth.from("2021-07");
const date = ym.toPlainDate({ day: 1 });
console.log(date.toString()); // 2021-07-01

const ym2 = Temporal.PlainYearMonth.from("2021-07-01[u-ca=chinese]");
const date2 = ym2.toPlainDate({ day: 15 });
console.log(date2.toString()); // 2021-06-24[u-ca=chinese]

Specifications

Specification
Temporal # sec-temporal.plainyearmonth.prototype.toplaindate

Browser compatibility

	Desktop					Mobile							Server
	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
`toPlainDate`	144	144	139	128	preview	144	139	95	No	No	144	No	1.4.0	2.7	26.0.0