← 返回首页
Date.prototype.setUTCMonth() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Web
  2. JavaScript
  3. Reference
  4. Standard built-in objects
  5. Date
  6. setUTCMonth()
Theme
  • OS default
  • Light
  • Dark
English (US)
Remember language Learn more

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.

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

In this article

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

Enable JavaScript to view this browser compatibility table.

See also

Help improve MDN

Was this page helpful to you?
Yes No
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
  1. Standard built-in objects
  2. Date
  3. Constructor
    1. Date()
  4. Static methods
    1. now()
    2. parse()
    3. UTC()
  5. Instance methods
    1. getDate()
    2. getDay()
    3. getFullYear()
    4. getHours()
    5. getMilliseconds()
    6. getMinutes()
    7. getMonth()
    8. getSeconds()
    9. getTime()
    10. getTimezoneOffset()
    11. getUTCDate()
    12. getUTCDay()
    13. getUTCFullYear()
    14. getUTCHours()
    15. getUTCMilliseconds()
    16. getUTCMinutes()
    17. getUTCMonth()
    18. getUTCSeconds()
    19. getYear()
    20. setDate()
    21. setFullYear()
    22. setHours()
    23. setMilliseconds()
    24. setMinutes()
    25. setMonth()
    26. setSeconds()
    27. setTime()
    28. setUTCDate()
    29. setUTCFullYear()
    30. setUTCHours()
    31. setUTCMilliseconds()
    32. setUTCMinutes()
    33. setUTCMonth()
    34. setUTCSeconds()
    35. setYear()
    36. toDateString()
    37. toISOString()
    38. toJSON()
    39. toLocaleDateString()
    40. toLocaleString()
    41. toLocaleTimeString()
    42. toString()
    43. toTemporalInstant()
    44. toTimeString()
    45. toUTCString()
    46. valueOf()
    47. [Symbol.toPrimitive]()
  6. Inheritance
  7. Object/Function
  8. Static methods
    1. apply()
    2. bind()
    3. call()
    4. toString()
    5. [Symbol.hasInstance]()
  9. Static properties
    1. displayName
    2. length
    3. name
    4. prototype
    5. arguments
    6. caller
  10. Instance methods
    1. __defineGetter__()
    2. __defineSetter__()
    3. __lookupGetter__()
    4. __lookupSetter__()
    5. hasOwnProperty()
    6. isPrototypeOf()
    7. propertyIsEnumerable()
    8. toLocaleString()
    9. toString()
    10. valueOf()
  11. Instance properties
    1. __proto__
    2. constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.