--- title: Date.prototype.setDate() slug: Web/JavaScript/Reference/Global_Objects/Date/setDate translation_of: Web/JavaScript/Reference/Global_Objects/Date/setDate ---
{{JSRef("Global_Objects", "Date")}}

setDate() 方法根据本地时间来指定一个日期对象的天数。

{{EmbedInteractiveExample("pages/js/date-setdate.html")}}

语法

dateObj.setDate(dayValue)

参数

dayValue
一个整数,表示该月的第几天。

描述

如果 dayValue 超出了月份的合理范围,setDate 将会相应地更新 Date 对象。

例如,如果为 dayValue 指定0,那么日期就会被设置为上个月的最后一天。

如果dayValue被设置为负数,日期会设置为上个月最后一天往前数这个负数绝对值天数后的日期。-1会设置为上月最后一天的前一天(译者注:例如当前为4月,如果setDate(-2),则为3月29日)

例子

例子:使用setDate方法

var theBigDay = new Date(1962, 6, 7); // 1962-07-07
theBigDay.setDate(24);  // 1962-07-24
theBigDay.setDate(32);  // 1962-08-01

规范

规范版本 规范状态 注解
ECMAScript 1st Edition. Implemented in JavaScript 1.0 Standard Initial definition.
{{SpecName('ES5.1', '#sec-15.9.5.36', 'Date.prototype.setDate')}} {{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-date.prototype.setdate', 'Date.prototype.setDate')}} {{Spec2('ES6')}}

浏览器兼容性

{{Compat("javascript.builtins.Date.setDate")}}

相关链接