The setDate()
method sets the day of the Date
object relative to the beginning of the currently set month.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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.
If a negative number is provided for dayValue
, the date will be set counting backwards from the last day of the previous month. -1 would result in the date being set to 1 day before the last day of the previous month.
Examples
Using setDate()
var theBigDay = new Date(1962, 6, 7); // 1962-07-07 (7th of July 1962) theBigDay.setDate(24); // 1962-07-24 (24th of July 1962) theBigDay.setDate(32); // 1962-08-01 (1st of August 1962) theBigDay.setDate(22); // 1962-08-22 (22th of August 1962) theBigDay.setDate(0); // 1962-07-31 (31th of July 1962) theBigDay.setDate(98); // 1962-10-06 (6th of October 1962) theBigDay.setDate(-50); // 1962-08-11 (11th of August 1962)
Specifications
Specification |
---|
ECMAScript (ECMA-262) The definition of 'Date.prototype.setDate' in that specification. |
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.
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
setDate | Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 3 | Opera Full support 3 | Safari Full support 1 | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support 10.1 | Safari iOS Full support 1 | Samsung Internet Android Full support 1.0 | nodejs Full support 0.1.100 |
Legend
- Full support
- Full support