JavaScript Date setDate() Method

What You’ll Learn

setDate() writes the calendar day-of-month (1–31) on a Date object in local time. This guide covers syntax, adding days, overflow normalization, return values, and comparisons with UTC setters.

Introduction

After reading a day with getDate(), you often need to change it—move a deadline, snap to the 1st of the month, or add seven days. setDate() is the local-time setter for that calendar day component.

Unlike getters, setters mutate the original Date. Clone first with new Date(date) when you need to preserve the old value.

Understanding the setDate() Method

Date.prototype.setDate(day) accepts an integer day-of-month. Values outside 1–31 are normalized—setting day 32 in January becomes February 1. That overflow behavior is what makes setDate(getDate() + n) the standard “add days” idiom.

The method returns the updated epoch milliseconds (same as getTime() after the change). For UTC day writes, use setUTCDate() instead.

📝 Syntax

dateObj.setDate(day)

Parameters

• day — Integer day-of-month. Values below 1 or above the month length roll into adjacent months.

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 new Date(year, monthIndex, day) for predictable local dates.

const date = new Date(2026, 2, 26); // March 26, 2026
date.setDate(10);

console.log(date.getDate());  // 10
console.log(date.getMonth()); // 2 (March)

10
2

const date = new Date(2026, 0, 28); // Jan 28, 2026
date.setDate(date.getDate() + 7);

console.log(date.getMonth()); // 1 (February)
console.log(date.getDate());  // 4

1
4

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

console.log("Returned ms:", ms);
console.log("getTime() matches:", ms === date.getTime()); // true

Returned ms: 1773945000000
getTime() matches: true

const date = new Date(2026, 1, 15); // Feb 15, 2026
date.setDate(31);

console.log(date.getMonth()); // 2 (March)
console.log(date.getDate());  // 3

2
3

const date = new Date(2026, 2, 10); // March 10, 2026
date.setMonth(3, 0); // day 0 of April = last day of March

console.log(date.getDate()); // 31

31

🚀 Common Use Cases

• Relative deadlines — add N days with setDate(getDate() + n).
• Billing cycles — snap to month-end or the 1st.
• Calendar UI — update the selected day when user picks a date.
• Reminder apps — shift events by whole days in local time.
• Form defaults — pre-fill “due in 14 days” on a Date field.
• Clone + mutate — copy a Date before calling setDate to keep originals.

📝 Notes

• setDate() mutates the original Date—clone if you need the old value.
• Overflow is normalized automatically—ideal for adding days, surprising if you expected clamping.
• Returns epoch milliseconds; invalid dates yield NaN.
• Use local setDate for user-facing calendars; use setUTCDate for UTC rules.
• For countdowns, subtract getTime() values—do not decrement setDate each tick.
• Combine with setMonth and setFullYear when changing multiple fields.

💡 Best Practices