Date.prototype.getUTCFullYear()

Baseline 已广泛支持

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

getUTCFullYear() 方法,用于 Date 实例,根据世界时返回此日期的年份。

试一试

const date1 = new Date("December 31, 1975, 23:15:30 GMT+11:00");
const date2 = new Date("December 31, 1975, 23:15:30 GMT-11:00");

console.log(date1.getUTCFullYear());
// Expected output: 1975

console.log(date2.getUTCFullYear());
// Expected output: 1976

语法

js
getUTCFullYear()

参数

无。

返回值

根据世界时返回给定日期的年份的整数。如果日期 无效,则返回 NaN

描述

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

示例

使用 getUTCFullYear()

以下示例将当前年份的四位数赋给变量 year

js
const today = new Date();
const year = today.getUTCFullYear();

规范

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

浏览器兼容性

另见