Date.prototype.setUTCDate()
The setUTCDate()
method changes the day of the month of a given Date
instance, based on UTC time.
To instead change the day of the month for a given Date
instance based on local time, use the setDate()
method.
Try it
Syntax
setUTCDate(dayValue)
Parameters
dayValue
-
An integer from 1 to 31, representing the day of the month.
Return value
The number of milliseconds between 1 January 1970 00:00:00 UTC and the updated date.
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 you use 40 for dayValue
, and the month stored in the Date
object is June, the day will be changed to 10 and the month will be incremented to July.
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 setUTCDate()
const theBigDay = new Date();
theBigDay.setUTCDate(20);
Specifications
Specification |
---|
ECMAScript Language Specification # sec-date.prototype.setutcdate |
Browser compatibility
BCD tables only load in the browser