Date.prototype.setUTCMinutes()

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.

Date 实例的 setUTCMinutes() 方法根据世界协调时来设置该日期的分钟数。

尝试一下

语法

js
setUTCMinutes(minutesValue)
setUTCMinutes(minutesValue, secondsValue)
setUTCMinutes(minutesValue, secondsValue, msValue)

参数

minutesValue

一个表示分钟的整数，介于 0 和 59 之间。

secondsValue 可选

一个表示秒数的整数，介于 0 和 59 之间。如果你指定了 secondsValue，则你必须同时指定 minutesValue。

msValue 可选

一个表示毫秒数的整数，介于 0 和 999 之间。如果你指定了 msValue，则你必须同时指定 minutesValue 和 secondsValue。

返回值

原地修改当前 Date 对象，并返回它的新时间戳。如果参数为 NaN（或其他会被强制转换为 NaN 的值，比如 undefined），则日期会被设置为无效日期，并返回 NaN。

描述

如果你没有指定参数 minutesValue 和 msValue，则使用 getUTCSeconds() 和 getUTCMilliseconds() 方法的返回值。

如果你指定的参数值在预期的范围之外，则 setUTCMinutes() 将尝试更新 Date 对象中对应的日期信息。例如，如果你为 secondsValue 使用了 100，那么分钟数将会增加 1（minutesValue + 1），而秒数将变成 40。

示例

使用 setUTCMinutes()

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

规范

Specification
ECMAScript Language Specification
# sec-date.prototype.setutcminutes

浏览器兼容性

BCD tables only load in the browser

参见