w3study.net

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

{{InteractiveExample("JavaScript Demo: Date.setUTCFullYear()")}}

```js interactive-example 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"

## 语法

```plain
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);