JavaScript Date setUTCMonth() Method

What You’ll Learn

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

Introduction

Billing cycles, ISO reports, and server-side date math often use UTC calendar fields. After reading the UTC month with getUTCMonth(), setUTCMonth() writes it back without local timezone offsets.

Like setMonth(), months are zero-indexed (0 = January, 11 = December) and the method mutates the Date in place, returning epoch milliseconds.

Understanding the setUTCMonth() Method

Date.prototype.setUTCMonth(monthIndex [, dayOfMonth]) accepts a UTC month index and an optional UTC day. When you pass only the month, the UTC day-of-month is not reset to 1—it stays the same unless overflow normalization rolls the calendar.

Verify results with toISOString() or UTC getters. For changing the UTC year, pair with setUTCFullYear().

📝 Syntax

dateObj.setUTCMonth(monthIndex)
dateObj.setUTCMonth(monthIndex, dayOfMonth)

Parameters

• monthIndex — Integer 0–11 (0 = January, 11 = December; overflow normalizes).
• dayOfMonth (optional) — UTC day of month (1–31 typical range; overflow normalizes).

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 Date.UTC() for predictable UTC calendar values.

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

console.log(date.getUTCMonth());  // 3
console.log(date.getUTCDate());   // 15
console.log(date.toISOString());  // "2026-04-15T00:00:00.000Z"

3
15
2026-04-15T00:00:00.000Z

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

console.log(date.getUTCMonth());     // 2 (March — overflow)
console.log(date.getUTCDate());      // 3
console.log(date.getUTCFullYear());  // 2026

2
3
2026

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

console.log(date.getUTCMonth());  // 5
console.log(date.getUTCDate());   // 15
console.log(date.toISOString());  // "2026-06-15T00:00:00.000Z"

5
15
2026-06-15T00:00:00.000Z

const start = new Date(Date.UTC(2026, 8, 10)); // Sep 10, 2026 UTC
const renewal = new Date(start);
renewal.setUTCMonth(renewal.getUTCMonth() + 3);

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

Start month: 8
Renewal month: 11

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

console.log(date.getUTCMonth());     // 0 (January)
console.log(date.getUTCFullYear());  // 2027

0
2027

🚀 Common Use Cases

• UTC subscription renewals — setUTCMonth(getUTCMonth() + 1) monthly billing.
• Quarterly UTC reports — add three months for ISO-aligned periods.
• Season pickers — map UI month names to 0–11 indices in UTC.
• First-of-month snaps — setUTCMonth(m, 1) for UTC billing anchors.
• End-of-month caution — validate Jan 31 UTC → Feb transitions.
• Clone + mutate — keep originals when computing future UTC dates.

📝 Notes

• Months are zero-indexed: 0 = January, 11 = December.
• Omitting the day argument does not reset the day to 1.
• Mutates the original Date—clone with new Date(date) when needed.
• Returns epoch ms, not the Date—no fluent chaining on the return value.
• Jan 31 → February can overflow into March (end-of-month trap).
• Use setMonth for local calendars; setUTCMonth for ISO/server rules.

💡 Best Practices