試一試
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 |
瀏覽器相容性
載入中…