JavaScript Date setMonth() Method

What You’ll Learn

setMonth() writes the calendar month (0–11) on a Date in local time, with an optional day-of-month. This guide covers zero-indexed months, end-of-month overflow, and relative month shifts.

Introduction

Billing cycles, subscription renewals, and “three months from today” rules need to change the month on a Date. After reading the month with getMonth(), setMonth() writes it back in local time.

Months are zero-indexed: January is 0, December is 11. Like other setters, setMonth() mutates the Date and returns epoch milliseconds—not the Date for chaining.

Understanding the setMonth() Method

Date.prototype.setMonth(monthIndex [, day]) accepts a month index and an optional day (1–31). When you omit day, the current day-of-month is kept—it does not reset to the 1st.

End-of-month dates can surprise you: Jan 31 plus February becomes March 3 in a non-leap year because February has only 28 days. For UTC month writes, use setUTCMonth().

📝 Syntax

dateObj.setMonth(monthIndex)
dateObj.setMonth(monthIndex, day)

Parameters

• monthIndex — Integer 0–11 (January–December). Values outside range normalize into adjacent years.
• day (optional) — Integer 1–31 for day-of-month. If omitted, the existing day is kept.

Return value

• Updated epoch milliseconds after the change.
• NaN if the Date was invalid before the call.

Examples Gallery

Open DevTools Console (F12) or use Try-it links. Examples use the Date constructor for predictable local calendar values.

const date = new Date(2026, 1, 15); // Feb 15, 2026
date.setMonth(3); // April

console.log(date.getMonth());  // 3
console.log(date.getDate());   // 15

3
15

const date = new Date(2026, 0, 31); // Jan 31, 2026
date.setMonth(1); // February

console.log(date.getMonth());     // 2 (March — overflow)
console.log(date.getDate());      // 3
console.log(date.getFullYear());  // 2026

2
3
2026

const date = new Date(2026, 0, 1); // Jan 1, 2026
date.setMonth(5, 15); // June 15

console.log(date.getMonth());  // 5
console.log(date.getDate());   // 15

5
15

const start = new Date(2026, 8, 10); // Sep 10, 2026
const renewal = new Date(start);
renewal.setMonth(renewal.getMonth() + 3);

console.log("Start month:", start.getMonth());      // 8
console.log("Renewal month:", renewal.getMonth());  // 11 (December)

Start month: 8
Renewal month: 11

const date = new Date(2026, 10, 20); // Nov 20, 2026
date.setMonth(12);

console.log(date.getMonth());     // 0 (January)
console.log(date.getFullYear());  // 2027

0
2027

🚀 Common Use Cases

• Subscription renewals — setMonth(getMonth() + 1) monthly billing.
• Quarter shifts — add three months for quarterly reports.
• Season pickers — map UI month names to 0–11 indices.
• First-of-month snaps — setMonth(m, 1) for billing anchors.
• End-of-month caution — validate Jan 31 → Feb transitions.
• Clone + mutate — keep originals when computing future dates.

📝 Notes

• Months are zero-indexed: 0 = January, 11 = December.
• Omitting day keeps the current day—it does not default to 1.
• Jan 31 → February is a common overflow trap; test end-of-month dates.
• Mutates the original Date—clone with new Date(date) when needed.
• Returns epoch ms, not the Date—no fluent chaining on the return value.
• Use setUTCMonth when rules follow UTC, not local wall calendar.

💡 Best Practices