THE WORLD'S LARGEST WEB DEVELOPER SITE

JavaScript setUTCMonth() Method

❮ JavaScript Date Object

Example

Set the month to 4 (May):

var d = new Date();
d.setUTCMonth(4);
Try it Yourself »

More "Try it Yourself" examples below.


Definition and Usage

The setUTCMonth() method sets the month (from 0 to 11), according to universal time.

Note: January is 0, February is 1, and so on.

This method can also be used to set the day of the month.

Tip: The Universal Coordinated Time (UTC) is the time set by the World Time Standard.

Note: UTC time is the same as GMT time.


Browser Support

Method
setUTCMonth() Yes Yes Yes Yes Yes

Syntax

Date.setUTCMonth(month, day)

Parameter Values

Parameter Description
month Required. An integer representing the month

Expected values are 0-11, but other values are allowed:

  • -1 will result in the last month of the previous year
  • 12 will result in the first month of the next year
  • 13 will result in the second month of the next year
day Optional. An integer representing the day of month

Expected values are 1-31, but other values are allowed:

  • 0 will result in the last hour of the previous month
  • -1 will result in the hour before the last hour of the previous month

If the month has 31 days:

  • 32 will result in the first day of the next month

If the month has 30 days:

  • 32 will result in the second day of the next month


Technical Details

Return Value: A Number, representing the number of milliseconds between the date object and midnight January 1 1970
JavaScript Version: ECMAScript 1

More Examples

Example

Set the month to 4 (May) and the day to the 20th:

var d = new Date();
d.setUTCMonth(4, 20);
Try it Yourself »

Example

Set the date to be the last day of last month:

var d = new Date();
d.setUTCMonth(d.getUTCMonth(), 0);
Try it Yourself »

❮ JavaScript Date Object