Date.prototype.getYear()

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

getYear() 方法用于获取此日期根据本地时间表示的年份。由于 getYear() 返回的年份不是完整的(存在“千年虫”问题),因此它已被弃用,并由 getFullYear() 方法取代。

语法

js
getYear()

参数

无。

返回值

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

  • 对于 2000 年及以后的年份,返回值将是 100 或更大。例如,如果年份是 2026,getYear() 将返回 126。
  • 对于 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® 2026 语言规范
# sec-date.prototype.getyear

浏览器兼容性

另见