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

浏览器兼容性

另见