Date.prototype.setUTCMinutes()

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

setUTCMinutes() 方法用于更改 Date 实例的分钟数,以协调世界时(UTC)为准。

试一试

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

语法

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

参数

minutesValue

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

secondsValue 可选

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

msValue 可选

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

返回值

该方法会直接修改 Date 对象,并返回其新的 时间戳。如果某个参数是 NaN(或被 强制转换NaN 的值,如 undefined),则日期将设置为 无效日期,并返回 NaN

描述

如果您未指定 secondsValuemsValue 参数,则将使用从 getUTCSeconds()getUTCMilliseconds() 方法返回的值。

如果您指定的参数超出了预期范围,setUTCMinutes() 会尝试相应地更新 Date 对象中的日期信息。例如,如果您将 secondsValue 设置为 100,则分钟数将增加 1(minutesValue + 1),秒数将设置为 40。

示例

使用 setUTCMinutes()

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

规范

规范
ECMAScript® 2026 语言规范
# sec-date.prototype.setutcminutes

浏览器兼容性

另见