JavaScript Date setUTCFullYear() 方法

定义和用法

setUTCFullYear() 方法根据 UTC 时间设置日期对象的年份（1000 年到 9999 年之间的四位数字）。

提示：世界协调时间 (UTC) 是由世界时间标准设定的时间。

注释：UTC 时间与 GMT 时间（格林威治时间）相同。

实例

例子 1

将年份设置为 1992：

var d = new Date();
d.setUTCFullYear(1992);

亲自试一试

例子 2

将日期设置为 2020 年 11 月 3 日：

var d = new Date();
d.setUTCFullYear(2020, 10, 3);

亲自试一试

例子 3

将日期设置为六个月前，UTC 时间：

var d = new Date();
d.setUTCFullYear(d.getUTCFullYear, d.getUTCMonth() - 6);

亲自试一试

语法

Date.setUTCFullYear(year, month, day)

参数值

参数 描述
year 必需的。表示年份的值，允许负值。
month

可选。表示月份的整数。

预期值为 0-11，但允许其他值：

  • -1 将导致上一年的最后一个月
  • 12 将导致明年的第一个月
  • 13 将导致明年的第二个月
day

必需。整数，表示一个月中的某一天。

预期值为 1-31，但允许其他值：

  • 0 将导致上个月的最后一天
  • -1 将导致上个月的最后一天的前一天

如果一个月有 31 天：

  • 32 将导致下个月的第一天

如果一个月有 30 天：

  • 32 将导致下个月的第二天

技术细节

返回值： 数值，日期对象与 1970 年 1 月 1 日午夜之间的毫秒数。
JavaScript 版本： ECMAScript 1

浏览器支持

方法 Chrome IE Firefox Safari Opera
setUTCFullYear() 支持 支持 支持 支持 支持

相关页面

教程：JavaScript 日期

教程：JavaScript 日期格式

教程：JavaScript 日期设置方法