试一试
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"
语法
js
setUTCFullYear(yearValue)
setUTCFullYear(yearValue, monthValue)
setUTCFullYear(yearValue, monthValue, dateValue)
参数
yearValue-
表示年份的整数。例如,1995。
monthValue可选-
一个整数,表示月份:0 表示一月,1 表示二月,以此类推。
dateValue可选-
表示月份中一天的整数(1-31)。如果指定了
dateValue,则必须同时指定monthValue。
返回值
该方法会直接修改 Date 对象,并返回其新的 时间戳。如果某个参数是 NaN(或被 强制转换 为 NaN 的值,如 undefined),则日期将设置为 无效日期,并返回 NaN。
描述
如果您不指定 monthValue 和 dateValue 参数,则将使用从 getUTCMonth() 和 getUTCDate() 方法返回的值。
如果您指定的参数超出预期范围,setUTCFullYear() 会尝试相应地更新 Date 对象中的其他参数和日期信息。例如,如果您为 monthValue 指定 15,年份将增加 1(yearValue + 1),月份将使用 3。
示例
使用 setUTCFullYear()
js
const theBigDay = new Date();
theBigDay.setUTCFullYear(1997);
规范
| 规范 |
|---|
| ECMAScript® 2026 语言规范 # sec-date.prototype.setutcfullyear |
浏览器兼容性
加载中…