Date.prototype.setUTCFullYear()

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

setUTCFullYear() 方法用於修改 Date 例項的年份(根據通用時間)。

試一試

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

描述

如果您不指定 monthValuedateValue 引數,則將使用從 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

瀏覽器相容性

另見