Date.prototype.setUTCMonth()

Baseline 已廣泛支援

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

setUTCMonth() 方法用於修改 Date 例項的月份和/或月份中的日期,該修改基於協調世界時 (UTC)。

試一試

const event = new Date("December 31, 1975 23:15:30 GMT-3:00");

console.log(event.toUTCString());
// Expected output: "Thu, 01 Jan 1976 02:15:30 GMT"

console.log(event.getUTCMonth());
// Expected output: 0

event.setUTCMonth(11);

console.log(event.toUTCString());
// Expected output: "Wed, 01 Dec 1976 02:15:30 GMT"

語法

js
setUTCMonth(monthValue)
setUTCMonth(monthValue, dateValue)

引數

monthValue

一個整數,表示月份:0 表示一月,1 表示二月,以此類推。

dateValue 可選

一個從 1 到 31 的整數,表示月份中的日期。

返回值

該方法會直接修改 Date 物件,並返回其新的 時間戳。如果某個引數是 NaN(或被 強制轉換NaN 的值,如 undefined),則日期將設定為 無效日期,並返回 NaN

描述

如果您不指定 dateValue 引數,則會使用 getUTCDate() 方法返回的值。

如果您指定的引數超出了預期範圍,setUTCMonth() 會嘗試相應地更新 Date 物件中的日期資訊。例如,如果您為 monthValue 使用 15,則年份將增加 1,月份將使用 3。

示例

使用 setUTCMonth()

js
const theBigDay = new Date();
theBigDay.setUTCMonth(11);

規範

規範
ECMAScript® 2026 語言規範
# sec-date.prototype.setutcmonth

瀏覽器相容性

另見