JavaScript Date setUTCFullYear() 方法

实例

将年份设置为 1992：

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

亲自试一试

页面下方有更多 TIY 实例。

定义和用法

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

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

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

浏览器支持

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

语法

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

更多实例

实例

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

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

亲自试一试

实例

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

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

亲自试一试

相关页面

教程：JavaScript 日期

教程：JavaScript 日期格式

教程：JavaScript 日期设置方法