此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Date.prototype.setUTCDate()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

Date 实例的 setUTCDate() 方法用于根据协调世界时(UTC)修改日期对象中的“日”。

尝试一下

const event = new Date("August 19, 1975 23:15:30 GMT-3:00"); console.log(event.getUTCDate()); // 预期输出:20 event.setUTCDate(19); console.log(event.getUTCDate()); // 预期输出:19 

语法

js
setUTCDate(dateValue) 

参数

dateValue

一个从 1 到 31 的整数,表示月份中的某一天。

返回值

会直接修改 Date 对象本身,并返回其新的时间戳。如果 dateValueNaN(或其他会被强制转换NaN 的值,例如 undefined),则日期会被设置为无效日期,并返回 NaN

描述

dateValue 超出了该月的日期范围,setDate() 会自动调整并更新 Date 对象。

例如,如果 dateValue 传入 0,日期将会被设置为上一个月的最后一天。若 dateValue 传入 40,而 Date 对象中保存的月份是 6 月,那么日期会被修改为 10 日,同时月份会递增到 7 月。

如果为 dateValue 提供一个负数,日期将会从上一个月的最后一天开始倒数计算。例如 -1,结果就是设置为上一个月最后一天的前一天。

示例

使用 setUTCDate()

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

规范

Specification
ECMAScript® 2026 Language Specification
# sec-date.prototype.setutcdate

浏览器兼容性

参见