GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • MDN
  • HTML: Markup language
  • Elements
  • Global attributes
  • Attributes
  • See all…
  • Responsive images
  • HTML cheatsheet
  • Date & time formats
  • See all…
  • SVG
  • MathML
  • XML
  • CSS: Styling language

This view

  • Original page
  • New address

GeezerVison is showing developer.mozilla.org — Date.prototype.setUTCMonth() - JavaScript | MDN

Date.prototype.setUTCMonth()

Baseline
Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

  • See full compatibility
  • Learn more

The setUTCMonth() method of Date instances changes the month and/or day of the month for this date according to universal time.

Try it

const event = new Date("December 31, 1975 23:15:30 GMT-3:00");

console.log(event.toUTCString());
// Expected output: "Thu, 01 Jan 1976 02:15:30 GMT"

console.log(event.getUTCMonth());
// Expected output: 0

event.setUTCMonth(11);

console.log(event.toUTCString());
// Expected output: "Wed, 01 Dec 1976 02:15:30 GMT"

Syntax

js
setUTCMonth(monthValue)
setUTCMonth(monthValue, dateValue)

Parameters

monthValue

An integer representing the month: 0 for January, 1 for February, and so on.

dateValue Optional

An integer from 1 to 31 representing the day of the month.

Return value

Changes the Date object in place, and returns its new timestamp. If a parameter is NaN (or other values that get coerced to NaN, such as undefined), the date is set to Invalid Date and NaN is returned.

Description

If you do not specify the dateValue parameter, the value returned from the getUTCDate() method is used.

If a parameter you specify is outside of the expected range, setUTCMonth() attempts to update the date information in the Date object accordingly. For example, if you use 15 for monthValue, the year will be incremented by 1, and 3 will be used for month.

Examples

Using setUTCMonth()

js
const theBigDay = new Date();
theBigDay.setUTCMonth(11);

Specifications

Specification
ECMAScript® 2027 Language Specification
# sec-date.prototype.setutcmonth

Browser compatibility

See also

  • Date.prototype.getUTCMonth()
  • Date.prototype.setMonth()

Help improve MDN

Learn how to contribute

This page was last modified on Jul 10, 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.