JS date setUTCMinutes()
**setUTCMinutes()
**方法会根据世界协调时(UTC)来设置指定日期的分钟数。
The source for this interactive example is stored in a GitHub repository. If you’d like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
语法
dateObj.setUTCMinutes(minutesValue[, secondsValue[, msValue]])
参数
minutesValue
必填,表示要设置的分钟数,是一个介于0和59之间的整数。
secondsValue
可选参数,表示要设置的秒数,同样也是一个介于0和59之间的整数,如果你传入了这个参数,那么你就必须要传入上一个参数(minutesValue
)。
msValue
可选参数,表示要设置的毫秒数,这是一个介于0和999之间的数字,如果你传入了这个参数,那么你就必须要传入前面两个参数(minutesValue
和secondsValue
)。
返回值
返回从UTC时间1970年1月1日0时0分0秒至设置后的时间的毫秒数。
说明
如果你没有传入后两个参数(minutesValue
和msValue
),这两个参数会分别使用getUTCSeconds()
和getUTCMilliseconds()
这两个方法返回的值。
如果你传入的参数值在上文所述范围之外的话,**setUTCMinutes()**
方法会尝试修改日期对象中的其他信息,比如说你为**secondsValue**
这个参数传入了100(译者注:规定范围是[0, 59]),那么第一个参数(**minutesValue**
)就会被加1,而秒数则变成了40。
例子
使用 setUTCMinutes()
var theBigDay = new Date();
theBigDay.setUTCMinutes(43);
规范
规范 | 状态 | 备注 |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | 首次被定义,在JavaScript 1.3版本被实现。 |
ECMAScript 5.1 (ECMA-262) Date.prototype.setUTCMinutes | Standard | |
ECMAScript 2015 (6th Edition, ECMA-262)Date.prototype.setUTCMinutes | Standard | |
ECMAScript Latest Draft (ECMA-262)Date.prototype.setUTCMinutes | Draft |