Date.prototype.getFullYear()

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

getFullYear() 方法用于获取 Date 实例的年份,根据本地时间。

请使用此方法而不是 getYear() 方法。

试一试

const moonLanding = new Date("July 20, 69 00:20:18");

console.log(moonLanding.getFullYear());
// Expected output: 1969

语法

js
getFullYear()

参数

无。

返回值

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

描述

getYear() 不同,getFullYear() 返回的值是绝对数字。对于 1000 年到 9999 年之间的日期,getFullYear() 返回一个四位数,例如 1995。使用此函数可确保年份符合 2000 年之后的年份。

示例

使用 getFullYear()

变量 fullYear 的值为 1995,基于 Date 对象 xmas95 的值。

js
const xmas95 = new Date("1995-12-25T23:15:30");
const fullYear = xmas95.getFullYear();

console.log(fullYear); // 1995

规范

规范
ECMAScript® 2026 语言规范
# sec-date.prototype.getfullyear

浏览器兼容性

另见