Temporal.PlainYearMonth.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.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 proposal # 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	Deno	Node.js
`toPlainDate`	No	No	No	No	No	No	No	No	No	No	No	1.40	No