Temporal.PlainDate.prototype.day

Limited availability

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

See full compatibility

The day accessor property of Temporal.PlainDate instances returns a positive integer representing the 1-based day index in the month of this date, which is the same day number you would see on a calendar. It is calendar-dependent.

It generally starts at 1 and is continuous, but not always. If you want to loop through all the days in a month, first use with() with { day: 1 } (which sets to the beginning of the month, even if the actual number is not 1), then repeatedly use add() with { days: 1 }, until the month changes.

Note: Usually, the day index only changes when transitioning from one calendar system into another, such as from the Julian to the Gregorian calendar. In practice, all currently built-in calendars are proleptic, meaning the calendar system is extended indefinitely into the past and future. Assuming day is non-continuous guards against future introductions of non-proleptic calendars.

The set accessor of day is undefined. You cannot change this property directly. Use the with() method to create a new Temporal.PlainDate object with the desired new value.

Examples

Using day

const date = Temporal.PlainDate.from("2021-07-01"); // ISO 8601 calendar
console.log(date.day); // 1

const date2 = Temporal.PlainDate.from("2021-07-01[u-ca=chinese]");
console.log(date2.day); // 22; it is May 22 in the Chinese calendar

Looping through all days in a month

const month = Temporal.PlainDate.from("2021-07-14"); // An arbitrary date in the month
for (
  let day = month.with({ day: 1 });
  day.month === month.month;
  day = day.add({ days: 1 })
) {
  console.log(day.day);
}

Changing day

const date = Temporal.PlainDate.from("2021-07-01");
const newDate = date.with({ day: 15 });
console.log(newDate.toString()); // 2021-07-15

You can also use add() or subtract() to move a certain number of days from the current date.

const date = Temporal.PlainDate.from("2021-07-01");
const newDate = date.add({ days: 14 });
console.log(newDate.toString()); // 2021-07-15

By default, with() constrains the day to the range of valid values. So you can use { day: 1 } to set the day to the first day of the month, even if the first day does not have the number 1. Similarly, the following will set the day to the last day of the month:

const date = Temporal.PlainDate.from("2021-07-01");
const lastDay = date.with({ day: Number.MAX_VALUE }); // 2021-07-31

Note: Avoid using daysInMonth to set the day to the last day of the month. The last day of the month is not always the same as the number of days in the month, in the rare case where a month may have a few days skipped.

Specifications

Specification
Temporal # sec-get-temporal.plaindate.prototype.day

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
`day`	Chrome – Full support Chrome 144 (Release date: 2026-01-13) footnote Full support	Edge – Full support Edge 144 (Release date: 2026-01-21) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 128 (Release date: 2026-02-26) footnote Full support	Safari – No support Safari footnote footnote See bug 223166	Chrome Android – Full support Chrome Android 144 (Release date: 2026-01-13) footnote Full support	Firefox for Android – Full support Firefox for Android 139 (Release date: 2025-05-27) footnote Full support	Opera Android – Full support Opera Android 95 (Release date: 2026-02-11) footnote Full support	Safari on iOS – No support Safari on iOS footnote footnote See bug 223166	Samsung Internet – No support Samsung Internet footnote No support	WebView Android – Full support WebView Android 144 (Release date: 2026-01-13) footnote Full support	WebView on iOS – No support WebView on iOS footnote footnote See bug 223166	Bun – No support Bun footnote No support	Deno – Full support Deno 2.7 (Release date: 2026-02-25) footnote Full support	Node.js – No support Node.js footnote No support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: See implementation notes.