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

View in English Always switch to English

Date.prototype.setUTCDate()

基线 广泛可用

自 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);

规范

规范
ECMAScript® 2027 Language Specification
# sec-date.prototype.setutcdate

浏览器兼容性

参见