Date.prototype.getYear()

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 getYear() method returns the year in the specified date according to local time. Because getYear() does not return full years ("year 2000 problem"), it is no longer used and has been replaced by the getFullYear() method.

Syntax

JavaScript
<var>dateObj</var>.getYear()

Return value

A number representing the year of the given date, according to local time, minus 1900.

Description

  • For years greater than or equal to 2000, the value returned by getYear() is 100 or greater. For example, if the year is 2026, getYear() returns 126.
  • For years between and including 1900 and 1999, the value returned by getYear() is between 0 and 99. For example, if the year is 1976, getYear() returns 76.
  • For years less than 1900, the value returned by getYear() is less than 0. For example, if the year is 1800, getYear() returns -100.

To take into account years before and after 2000, you should use getFullYear() instead of getYear() so that the year is specified in full.

Backward compatibility

Behavior in JavaScript 1.2 and earlier

The getYear() method returns either a 2-digit or 4-digit year:

  • For years between and including 1900 and 1999, the value returned by getYear() is the year minus 1900. For example, if the year is 1976, the value returned is 76.
  • For years less than 1900 or greater than 1999, the value returned by getYear() is the four-digit year. For example, if the year is 1856, the value returned is 1856. If the year is 2026, the value returned is 2026.

Examples

Years between 1900 and 1999

The second statement assigns the value 95 to the variable year.

JavaScript
var Xmas = new Date('December 25, 1995 23:15:00');
var year = Xmas.getYear(); // returns 95

Years above 1999

The second statement assigns the value 100 to the variable year.

JavaScript
var Xmas = new Date('December 25, 2000 23:15:00');
var year = Xmas.getYear(); // returns 100

Years below 1900

The second statement assigns the value -100 to the variable year.

JavaScript
var Xmas = new Date('December 25, 1800 23:15:00');
var year = Xmas.getYear(); // returns -100

Setting and getting a year between 1900 and 1999

The third statement assigns the value 95 to the variable year, representing the year 1995.

JavaScript
var Xmas = new Date('December 25, 2015 23:15:00');
Xmas.setYear(95);
var year = Xmas.getYear(); // returns 95

Specifications

Specification Status Comment
ECMAScript 1st Edition (ECMA-262) Standard Initial definition. Implemented in JavaScript 1.3.
ECMAScript 5.1 (ECMA-262)
The definition of 'Date.prototype.getYear' in that specification.
Standard Defined in the (informative) compatibility annex.
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Date.prototype.getYear' 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.getYear' in that specification.
Draft  

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)

See also

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/javascript/reference/global_objects/date/getyear

Date Deprecated JavaScript Method Prototype Reference