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 表仅在浏览器中加载