JavaScript Date setFullYear() Method

What You’ll Learn

setFullYear() writes the four-digit year on a Date object in local time, with optional month and day overload. This guide covers syntax, increment patterns, leap-year normalization, and comparisons with UTC setters.

Introduction

Renewals, birthdays, and fiscal rollovers often need to bump a date by one year or snap to a specific calendar day. After reading the year with getFullYear(), setFullYear() is the local-time setter that writes it back.

Like other Date setters, it mutates the original object. Clone with new Date(date) when you must keep the previous instant.

Understanding the setFullYear() Method

Date.prototype.setFullYear(year [, monthIndex [, day]]) accepts a four-digit year and optional zero-based month and day. When you pass only the year, month and day stay the same—unless normalization is required (for example Feb 29 in a non-leap year).

The method returns epoch milliseconds, not the Date object. Call each setter on the same Date variable when you need multiple changes—do not chain on the numeric return value.

📝 Syntax

dateObj.setFullYear(year)
dateObj.setFullYear(year, monthIndex)
dateObj.setFullYear(year, monthIndex, day)

Parameters

• year — Four-digit integer (e.g. 2027).
• monthIndex (optional) — Zero-based month 0–11 (January = 0).
• day (optional) — Day-of-month 1–31; requires monthIndex when provided.

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, 1, 26); // Feb 26, 2026
date.setFullYear(2027);

console.log(date.getFullYear()); // 2027
console.log(date.getMonth());    // 1 (February)
console.log(date.getDate());     // 26

2027
1
26

const date = new Date(2026, 1, 26);
date.setFullYear(2027, 6, 15); // July 15, 2027

console.log(date.getFullYear()); // 2027
console.log(date.getMonth());    // 6 (July)
console.log(date.getDate());     // 15

2027
6
15

const renewal = new Date(2026, 2, 15); // March 15, 2026
renewal.setFullYear(renewal.getFullYear() + 1);

console.log(renewal.getFullYear()); // 2027
console.log(renewal.getMonth());      // 2 (March)
console.log(renewal.getDate());       // 15

2027
2
15

const date = new Date(2026, 1, 26);
const ms = date.setFullYear(2027);

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

// Correct multi-step updates on the same Date:
date.setFullYear(2028);
date.setMonth(11);
date.setDate(31);

Returned ms: number
Matches getTime(): true

const date = new Date(2024, 1, 29); // Feb 29, 2024
date.setFullYear(2025);

console.log(date.getFullYear()); // 2025
console.log(date.getMonth());    // 2 (March)
console.log(date.getDate());     // 1

2025
2
1

🚀 Common Use Cases

• Subscription renewals — bump expiry by one year.
• Date pickers — apply user-selected year to an existing Date.
• Fiscal year rollovers — set year while keeping month/day anchors.
• Form assembly — combine year, month, day with the three-arg overload.
• Historical dates — set years before 1000 or after 9999 (four-digit API).
• Clone + mutate — copy a Date before changing the year for comparisons.

📝 Notes

• setFullYear() mutates the original Date—clone if you need the old value.
• Month argument is zero-based (January = 0), same as getMonth().
• Returns epoch ms, not the Date—no fluent chaining on the return value.
• Feb 29 in non-leap years normalizes to March 1 (or similar overflow).
• Use setUTCFullYear when rules follow UTC, not local time.
• Validate with Number.isNaN(date.getTime()) before calling setters on parsed dates.

💡 Best Practices