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

View in English Always switch to English

Date.prototype.setMonth()

基线 广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

setMonth() 方法根据本地时间为一个日期对象设置月份。

尝试一下

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

event.setMonth(3);

console.log(event.getMonth());
// Expected output: 3

console.log(event);
// Expected output: "Sat Apr 19 1975 23:15:30 GMT+0100 (CET)"
// Note: your timezone may vary

语法

dateObj.setMonth(monthValue[, dayValue])

JavaScript 1.3 版本之前

dateObj.setMonth(monthValue)

参数

monthValue

介于 0 到 11 之间的整数(表示一月到十二月)。

dayValue

从 1 到 31 之间的整数,表示月份中的第几天。0 为上个月最后一天

返回值!

基于 1 January 1970 00:00:00 UTC 开始计算的毫秒数

描述

如果不指定 dayValue 参数,就会使用 getDate 方法的返回值。

如果有一个指定的参数超出了合理范围,setMonth 会相应地更新日期对象中的日期信息。例如,为 monthValue 指定 15,则年份会加 1,月份将会使用 3。

示例

示例:使用 setMonth 方法

js
var theBigDay = new Date();
theBigDay.setMonth(6);

规范

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

浏览器兼容性

参见