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 日期设置方法