--- title: Date.prototype.setUTCMilliseconds() slug: Web/JavaScript/Reference/Global_Objects/Date/setUTCMilliseconds translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCMilliseconds ---
{{JSRef}}

setUTCMilliseconds() 方法会根据世界时来设置指定时间的毫秒数。

{{EmbedInteractiveExample("pages/js/date-setutcmilliseconds.html")}}

语法

dateObj.setUTCMilliseconds(millisecondsValue)

参数

millisecondsValue
0 - 999 之间的数值,代表毫秒数。

返回值

返回更新后的时间距 1970 年 1 月 1 日 00:00:00 (UTC) 的毫秒数。

描述

如果传递的参数超出了指定的范围,setUTCMilliseconds() 方法会相应地尝试更新储存在 {{jsxref("Date")}}  的时间信息。例如,假设你传递参数的值是 1100,存储在 {{jsxref("Date")}} 的秒数会加 1,然后使用 100 来作为毫秒数。

示例

使用 setUTCMilliseconds() 方法

var theBigDay = new Date();
theBigDay.setUTCMilliseconds(500);

规范

规范版本 规范状态 注解
{{SpecName('ES1')}} {{Spec2('ES1')}} 初始定义。于 JavaScript 1.3 实现。
{{SpecName('ES5.1', '#sec-15.9.5.29', 'Date.prototype.setUTCMilliseconds')}} {{Spec2('ES5.1')}}  
{{SpecName('ES6', '#sec-date.prototype.setutcmilliseconds', 'Date.prototype.setUTCMilliseconds')}} {{Spec2('ES6')}}  
{{SpecName('ESDraft', '#sec-date.prototype.setutcmilliseconds', 'Date.prototype.setUTCMilliseconds')}} {{Spec2('ESDraft')}}  

浏览器兼容性

{{Compat("javascript.builtins.Date.setUTCMilliseconds")}}

相关链接