此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Date.prototype.getYear()

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.

getYear() 方法返回指定的本地日期的年份。因为 getYear() 不返回千禧年(“2000 年问题”),所以这个方法不再被使用,现在替换为 getFullYear。

语法

js
getYear()

返回值

getYear 方法返回一个年份减去 1900 的值;因此:

  • 如果年份大于等于 2000,则 getYear() 的返回值将大于等于 100。例如,如果年份是 2026,则 getYear() 返回 126。
  • 如果年份在 1900 到 1999 之间,getYear() 的返回值将在 0 到 99 之间。例如,如果年份是 1976,则 getYear() 返回 76。
  • 如果年份小于 1900,则 getYear() 的返回值将小于 0。例如,如果年份是 1800,则 getYear() 返回 -100。

如果要同时考虑 2000 年之前和之后的年份,应该使用 getFullYear() 而不是 getYear(),以便指定完整年份。

示例

1900 年到 1999 年之间的年份

第二个语句将值 95 赋给变量 year。

js
const xmas = new Date("1995-12-25");
const year = xmas.getYear(); // 返回 95

年份大于 1999

第二个语句将值 100 赋给变量 year。

js
const xmas = new Date("2000-12-25");
const year = xmas.getYear(); // 返回 100

年份小于 1900

第二个语句将值 -100 赋给变量 year。

js
const xmas = new Date("1800-12-25");
const year = xmas.getYear(); // 返回 -100

设置和获取 1900 年到 1999 年之间的年份

第三个语句将值 95 赋给变量 year,表示 1995 年。

js
const xmas = new Date("2015-12-25");
xmas.setYear(95);
const year = xmas.getYear(); // 返回 95

规范

规范
ECMAScript® 2027 Language Specification
# sec-date.prototype.getyear

浏览器兼容性

参见