GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • MDN
  • HTML: Markup language
  • Elements
  • Global attributes
  • Attributes
  • See all…
  • Responsive images
  • HTML cheatsheet
  • Date & time formats
  • See all…
  • SVG
  • MathML
  • XML
  • CSS: Styling language

This view

  • Original page
  • New address

GeezerVison is showing developer.mozilla.org — Date.prototype.setYear() - JavaScript | MDN

Date.prototype.setYear()

Deprecated

Avoid using this feature in new projects. The getYear() and setYear() methods use a truncated number instead of the actual year number, known as a year 2000 problem. This feature may be a candidate for removal from web standards or browsers.

  • See full compatibility
  • Learn more

The setYear() method of Date instances sets the year for a specified date according to local time.

However, the way the legacy setYear() method sets year values is different from how the preferred setFullYear() method sets year values — and in some cases, also different from how new Date() and Date.parse() set year values. Specifically, given two-digit numbers, such as 22 and 61:

  • setYear() interprets any two-digit number as an offset to 1900; so date.setYear(22) results in the year value being set to 1922, and date.setYear(61) results in the year value being set to 1961. (In contrast, while new Date(61, 1) also results in the year value being set to 1961, new Date("2/1/22") results in the year value being set to 2022; and similarly for Date.parse()).

  • setFullYear() does no special interpretation but instead uses the literal two-digit value as-is to set the year; so date.setFullYear(61) results in the year value being set to 0061, and date.setFullYear(22) results in the year value being set to 0022.

Because of those differences in behavior, you should no longer use the legacy setYear() method, but should instead use the preferred setFullYear() method.

Syntax

js
setYear(yearValue)

Parameters

yearValue

An integer.

Return value

Changes the Date object in place, and returns its new timestamp. If yearValue is NaN (or other values that get coerced to NaN, such as undefined), the date is set to Invalid Date and NaN is returned.

Description

If yearValue is a number between 0 and 99 (inclusive), then the year for dateObj is set to 1900 + yearValue. Otherwise, the year for dateObj is set to yearValue.

Examples

Using setYear()

The first two lines set the year to 1996. The third sets the year to 2000.

js
const theBigDay = new Date();

theBigDay.setYear(96);
theBigDay.setYear(1996);
theBigDay.setYear(2000);

Specifications

Specification
ECMAScript® 2027 Language Specification
# sec-date.prototype.setyear

Browser compatibility

See also

  • Polyfill of Date.prototype.setYear in core-js
  • Date.prototype.getFullYear()
  • Date.prototype.getUTCFullYear()
  • Date.prototype.setFullYear()
  • Date.prototype.setUTCFullYear()

Help improve MDN

Learn how to contribute

This page was last modified on Oct 26, 2026 by MDN contributors.

View this page on GitHub • Report a problem with this content
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.