Date.prototype.setUTCFullYear()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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()
js
var theBigDay = new Date();
theBigDay.setUTCFullYear(1997);
规范
Specification |
---|
ECMAScript® 2025 Language Specification # sec-date.prototype.setutcfullyear |
浏览器兼容性
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
setUTCFullYear |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.