title | slug | page-type | browser-compat |
---|---|---|---|
Date.prototype.setUTCMinutes() |
Web/JavaScript/Reference/Global_Objects/Date/setUTCMinutes |
javascript-instance-method |
javascript.builtins.Date.setUTCMinutes |
{{JSRef}}
The setUTCMinutes()
method of {{jsxref("Date")}} instances changes the minutes for this date according to universal time.
{{EmbedInteractiveExample("pages/js/date-setutcminutes.html")}}
setUTCMinutes(minutesValue)
setUTCMinutes(minutesValue, secondsValue)
setUTCMinutes(minutesValue, secondsValue, msValue)
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 specifyminutesValue
.
- : An integer between 0 and 59 representing the seconds. If you specify
msValue
{{optional_inline}}- : An integer between 0 and 999 representing the milliseconds. If you specify
msValue
, you must also specifyminutesValue
andsecondsValue
.
- : An integer between 0 and 999 representing the milliseconds. If you specify
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.
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.
const theBigDay = new Date();
theBigDay.setUTCMinutes(43);
{{Specifications}}
{{Compat}}
- {{jsxref("Date.prototype.getUTCMinutes()")}}
- {{jsxref("Date.prototype.setMinutes()")}}