JavaScript Date setUTCDate() Method

What You’ll Learn

setUTCDate() writes the day-of-month (1–31) on a Date in UTC. This guide covers syntax, UTC day arithmetic, overflow, and comparisons with local setDate().

Introduction

ISO timestamps, server logs, and global billing often follow UTC calendar rules. After reading the UTC day with getUTCDate(), setUTCDate() writes it back without using local timezone offsets.

Like setDate(), it mutates the Date and returns epoch milliseconds. Use UTC getters and setters together—do not mix local setDate with UTC getUTCDate in one calculation.

Understanding the setUTCDate() Method

Date.prototype.setUTCDate(dayOfMonth) accepts an integer for the UTC calendar day. Values outside 1–31 normalize into adjacent UTC months—the same overflow behavior as local setDate().

UTC time-of-day fields (hours, minutes, seconds) stay the same unless day overflow rolls the UTC calendar. Verify results with toISOString() or getUTCDate().

📝 Syntax

dateObj.setUTCDate(dayOfMonth)

Parameters

• dayOfMonth — Integer 1–31 in UTC (overflow normalizes; day 0 rolls to the last day of the previous UTC month).

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, 10, 12, 0, 0));
date.setUTCDate(15);

console.log(date.getUTCDate());   // 15
console.log(date.toISOString());  // "2026-02-15T12:00:00.000Z"

15
2026-02-15T12:00:00.000Z

const date = new Date(Date.UTC(2026, 0, 28, 0, 0, 0));
date.setUTCDate(date.getUTCDate() + 7);

console.log(date.getUTCMonth());  // 1 (February)
console.log(date.getUTCDate());   // 4

1
4

const date = new Date(Date.UTC(2026, 2, 15));
const ms = date.setUTCDate(20);

console.log("Type:", typeof ms);                    // "number"
console.log("Matches getTime():", ms === date.getTime()); // true

Type: number
Matches getTime(): true

const date = new Date(Date.UTC(2026, 0, 15, 8, 0, 0));
date.setUTCDate(32);

console.log(date.getUTCMonth());  // 1 (February)
console.log(date.getUTCDate());   // 1

1
1

const date = new Date(Date.UTC(2026, 1, 10)); // Feb 10 UTC
date.setUTCMonth(date.getUTCMonth() + 1, 0);   // March 0 = last day of Feb

console.log(date.getUTCDate());   // 28
console.log(date.toISOString());  // "2026-02-28T00:00:00.000Z"

28
2026-02-28T00:00:00.000Z

🚀 Common Use Cases

• ISO date math — shift UTC days on parsed timestamps.
• Global billing — anchor renewals to UTC calendar days.
• Log aggregation — bucket by UTC day with getUTCDate / setUTCDate.
• Server schedules — cron rules that follow UTC, not local wall clock.
• Month-end UTC — last-day helpers via day 0 overflow.
• Clone + mutate — copy before changing UTC days for comparisons.

📝 Notes

• setUTCDate() changes the UTC calendar day—not the local one from getDate().
• Use UTC getters with UTC setters; mixing local and UTC in one label causes off-by-one bugs.
• Day 0 is valid—it means the last day of the previous UTC month.
• Mutates the original Date—clone with new Date(date) when needed.
• Returns epoch ms, not the Date—no fluent chaining on the return value.
• Prefer toISOString() to verify UTC results in examples and tests.

💡 Best Practices