Date.prototype.getYear()

已弃用:此功能不再推荐。虽然一些浏览器可能仍然支持它,但它可能已被从相关的 Web 标准中删除,可能正在被删除,或者可能仅出于兼容性目的而保留。避免使用它,并尽可能更新现有代码;请参阅此页面底部的兼容性表以指导您的决定。请注意,此功能可能随时停止工作。

getYear() 方法是 Date 实例的方法,它根据本地时间返回此日期的年份。因为 getYear() 不返回完整的年份(“2000 年问题”),所以它已弃用,并被 getFullYear() 方法取代。

语法

js
getYear()

参数

无。

返回值

表示根据本地时间给定日期的年份的整数,减去 1900。如果日期无效,则返回 NaN

  • 对于大于或等于 2000 年的年份,该值为 100 或更大。例如,如果年份是 2026,则 getYear() 返回 126。
  • 对于 1900 年至 1999 年之间的年份(包括 1900 年和 1999 年),getYear() 返回的值在 0 到 99 之间。例如,如果年份是 1976,则 getYear() 返回 76。
  • 对于小于 1900 年的年份,getYear() 返回的值小于 0。例如,如果年份是 1800,则 getYear() 返回 -100。

此方法本质上返回 getFullYear() 的值减去 1900。您应该使用 getFullYear(),以便年份以完整的形式指定。

示例

1900 年到 1999 年之间的年份

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

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

1999 年之后的年份

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

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

1900 年之前的年份

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

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

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

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

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

规范

规范
ECMAScript 语言规范
# sec-date.prototype.getyear

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅