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. Do not use it in old or new projects. Pages or Web apps using it may break 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 2017 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
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |