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 2015年7月.
Date
实例的 setUTCMinutes()
方法根据世界协调时来设置该日期的分钟数。
尝试一下
const date1 = new Date("December 31, 1975, 23:15:30 GMT+11:00");
console.log(date1.getUTCMinutes());
// Expected output: 15
date1.setUTCMinutes(25);
console.log(date1.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
,则你必须同时指定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® 2026 Language Specification> # sec-date.prototype.setutcminutes> |
浏览器兼容性
Loading…