Temporal.PlainDate()

Syntax

new Temporal.PlainDate(year, month, day)
new Temporal.PlainDate(year, month, day, calendar)

Parameters

year

A number, truncated to an integer, representing the year in the ISO calendar system.

month

A number, truncated to an integer, representing the month in the ISO calendar system.

day

A number, truncated to an integer, representing the day of the month in the ISO calendar system.

calendar Optional

A string representing the calendar to use. See Intl.supportedValuesOf() for a list of commonly supported calendar types. Defaults to "iso8601". Note that irrespective of the calendar, the year, month, and day must be in the ISO 8601 calendar system.

Return value

A new Temporal.PlainDate object, representing the date specified by year, month, day (in the ISO calendar), interpreted in the calendar system specified by calendar.

Exceptions

TypeError

Thrown if calendar is not a string or undefined.

RangeError

Thrown in one of the following cases:

• year, month, or day is not a finite number.
• The year, month, and day combination does not represent a valid date in the ISO calendar system, or is not in the representable range, which is ±(10⁸ + 1) days, or about ±273,972.6 years, from the Unix epoch.
• calendar is not a valid calendar identifier.

Examples

Using Temporal.PlainDate()

const plainDate = new Temporal.PlainDate(2021, 7, 1);
console.log(plainDate.toString()); // 2021-07-01

// Note that the date is stored internally as ISO 8601, even when it's
// interpreted in a different calendar system. For example, even though
// 2021-07-01 ISO is 5781-10-21 in the Hebrew calendar, you still pass the
// ISO date to the constructor.
const plainDate2 = new Temporal.PlainDate(2021, 7, 1, "hebrew");
console.log(plainDate2.toString()); // 2021-07-01[u-ca=hebrew]
console.log(plainDate2.year); // 5781
console.log(plainDate2.month); // 10
console.log(plainDate2.day); // 21

Specifications

Browser compatibility

See also

• Temporal.PlainDate
• Temporal.PlainDate.from()