setUTCFullYear() 方法根据世界标准时间为一个具体日期设置年份。
JavaScript Demo: Date.setUTCFullYear()
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"
语法
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);
规范
浏览器兼容性
参见
- Date.prototype.getUTCFullYear()
- Date.prototype.setFullYear()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
