Date.prototype.setUTCDate()

Baseline 已廣泛支援

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

setUTCDate() 方法用於更改 Date 例項的月份中的某一天,該方法根據通用時間進行調整。

試一試

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

console.log(event.getUTCDate());
// Expected output: 20

event.setUTCDate(19);

console.log(event.getUTCDate());
// Expected output: 19

語法

js
setUTCDate(dateValue)

引數

dateValue

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

返回值

該方法會直接修改 Date 物件,並返回其新的 時間戳。如果 dateValueNaN(或其他被 強制轉換NaN 的值,例如 undefined),則該日期將被設定為 Invalid Date,並返回 NaN

描述

如果 dateValue 超出了該月份的有效日期範圍,setDate() 將相應地更新 Date 物件。

例如,如果為 dateValue 傳入 0,日期將設定為上個月的最後一天。如果你為 dateValue 傳入 40,並且 Date 物件中儲存的月份是六月,那麼日期將變為 10,月份將增加到七月。

如果為 dateValue 傳入一個負數,日期將從上個月的最後一天開始倒計數。-1 將導致日期設定為上個月最後一天之前的 1 天。

示例

使用 setUTCDate()

js
const theBigDay = new Date();
theBigDay.setUTCDate(20);

規範

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

瀏覽器相容性

另見