Date.prototype.setUTCMinutes()

The setUTCMinutes() method of {{jsxref("Date")}} instances changes the minutes for this date according to universal time.

{{InteractiveExample("JavaScript Demo: Date.prototype.setUTCMinutes()")}}

```js interactive-example const date = new Date("December 31, 1975, 23:15:30 GMT+11:00");

console.log(date.getUTCMinutes()); // Expected output: 15

date.setUTCMinutes(25);

console.log(date.getUTCMinutes()); // Expected output: 25

## Syntax

```js-nolint
setUTCMinutes(minutesValue)
setUTCMinutes(minutesValue, secondsValue)
setUTCMinutes(minutesValue, secondsValue, msValue)

Parameters#

• minutesValue
• : An integer between 0 and 59 representing the minutes.
• secondsValue {{optional_inline}}
• : An integer between 0 and 59 representing the seconds. If you specify secondsValue, you must also specify minutesValue.
• msValue {{optional_inline}}
• : An integer between 0 and 999 representing the milliseconds. If you specify msValue, you must also specify minutesValue and secondsValue.

Return value#

Changes the {{jsxref("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 secondsValue and msValue parameters, the values returned from {{jsxref("Date/getUTCSeconds", "getUTCSeconds()")}} and {{jsxref("Date/getUTCMilliseconds", "getUTCMilliseconds()")}} methods are used.

If a parameter you specify is outside of the expected range, setUTCMinutes() attempts to update the date information in the {{jsxref("Date")}} object accordingly. For example, if you use 100 for secondsValue, the minutes will be incremented by 1 (minutesValue + 1), and 40 will be used for seconds.

Examples#

Using setUTCMinutes()#

const theBigDay = new Date();
theBigDay.setUTCMinutes(43);

Specifications#

{{Specifications}}

Browser compatibility#

{{Compat}}

See also#

• {{jsxref("Date.prototype.getUTCMinutes()")}}
• {{jsxref("Date.prototype.setMinutes()")}}