The setDate()
method sets the day of the Date
object relative to the beginning of the currently set month.
Syntax
dateObj.setDate(dayValue)
Parameters
dayValue
- An integer representing the day of the month.
Return value
The number of milliseconds between 1 January 1970 00:00:00 UTC and the given date (the Date
object is also changed in place).
Description
If the dayValue
is outside of the range of date values for the month, setDate()
will update the Date
object accordingly. For example, if 0 is provided for dayValue
, the date will be set to the last day of the previous month.
Examples
Using setDate()
var theBigDay = new Date(1962, 6, 7); // 1962-07-07 theBigDay.setDate(24); // 1962-07-24 theBigDay.setDate(32); // 1962-08-01 theBigDay.setDate(22); // 1962-08-22
Specifications
Specification | Status | Comment |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Initial definition. Implemented in JavaScript 1.0. |
ECMAScript 5.1 (ECMA-262) The definition of 'Date.prototype.setDate' in that specification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Date.prototype.setDate' in that specification. |
Standard | |
ECMAScript Latest Draft (ECMA-262) The definition of 'Date.prototype.setDate' in that specification. |
Draft |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Feature | Chrome | Firefox | Edge | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |