Date.prototype.setYear()

Deprecated
This feature has been removed from the Web standards. Though some browsers may still support it, it is in the process of being dropped. Avoid using it and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

The setYear() method sets the year for a specified date according to local time. Because setYear() does not set full years ("year 2000 problem"), it is no longer used and has been replaced by the setFullYear() method.

Syntax

dateObj.setYear(yearValue)

Parameters

yearValue
An integer.

Return value

The number of milliseconds between 1 January 1970 00:00:00 UTC and the updated date.

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.

var theBigDay = new Date();
theBigDay.setYear(96);
theBigDay.setYear(1996);
theBigDay.setYear(2000);

Specifications

Specification Status Comment
ECMAScript 1st Edition (ECMA-262) Standard Initial definition. Implemented in JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
The definition of 'Date.prototype.setYear' in that specification.
Standard Defined in the (informative) compatibility annex.
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Date.prototype.setYear' in that specification.
Standard Defined in the (normative) annex for additional features for web browsers.
ECMAScript Latest Draft (ECMA-262)
The definition of 'Date.prototype.setYear' in that specification.
Draft Defined in the (normative) annex for additional features for web browsers.

Browser compatibility

FeatureChromeFirefoxEdgeInternet ExplorerOperaSafari
Basic Support(Yes)(Yes)(Yes)(Yes)(Yes)(Yes)
FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic Support(Yes)(Yes)(Yes)(Yes)(Yes)(Yes)(Yes)

See also

Document Tags and Contributors

 Contributors to this page: fscholz, jameshkramer, eduardoboucas, Mingun, Sheppy, evilpie, Ptak82, Maian, Prodoc, Dria
 Last updated by: fscholz,