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
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Feature | Chrome | Firefox | Edge | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |