此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
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)修改日期对象中的“日”。
In this article
尝试一下
const event = new Date("August 19, 1975 23:15:30 GMT-3:00");console.log(event.getUTCDate());// 预期输出:20event.setUTCDate(19);console.log(event.getUTCDate());// 预期输出:19语法
js
setUTCDate(dateValue)参数
dateValue一个从 1 到 31 的整数,表示月份中的某一天。
返回值
会直接修改Date 对象本身,并返回其新的时间戳。如果dateValue 为NaN(或其他会被强制转换为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> |