大网数据广告活动
Web 标准与前端开发

Date.prototype.setUTCFullYear()

· 52CE 我爱测

**`setUTCFullYear()`** 方法根据世界标准时间为一个具体日期设置年份。

setUTCFullYear() 方法根据世界标准时间为一个具体日期设置年份。

JavaScript Demo: Date.setUTCFullYear()

const event = new Date("December 31, 1975 23:15:30 GMT-3:00");

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

console.log(event.toUTCString());
// Expected output: "Thu, 01 Jan 1976 02:15:30 GMT"

event.setUTCFullYear(1975);

console.log(event.toUTCString());
// Expected output: "Wed, 01 Jan 1975 02:15:30 GMT"

语法

dateObj.setUTCFullYear(yearValue[, monthValue[, dayValue]])

参数

  • yearValue
    • : 指定年份整数值,例如,1995
  • monthValue
    • : 可选。指定一个 0-11 之间的整数值,代表从一月到十二月。
  • dayValue
    • : 可选。指定一个 1-31 之间的整数值,代表月份中的第几天。如果你指定了 dayValue 参数,那么你必须指定 monthValue 参数。

描述

如果你没有指定具体的 monthValue 和 dayValue,将会使用 getUTCMonth 和 getUTCDate 方法的返回值。

如果你指定的参数超出了期待范围,setUTCFullYear() 方法将会根据 Date 对象,更新其他参数和日期信息。例如,如果你将 monthValue 设定为 15,年份会增加 1,月份值则为 3。

示例

使用 setUTCFullYear()

var theBigDay = new Date();
theBigDay.setUTCFullYear(1997);

规范

浏览器兼容性

参见

  • Date.prototype.getUTCFullYear()
  • Date.prototype.setFullYear()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。