--- title: Date.UTC() slug: Web/JavaScript/Reference/Global_Objects/Date/UTC tags: - Date - JavaScript - Method translation_of: Web/JavaScript/Reference/Global_Objects/Date/UTC ---
Date.UTC()
方法接受的参数同日期构造函数接受最多参数时一样,返回从1970-1-1 00:00:00 UTC到指定日期的的毫秒数。
Date.UTC(year,month[,date[,hrs[,min[,sec{{mediawiki.external(',ms')}}]]]])
year
month
date
hrs
min
sec
ms
UTC
方法接受以逗号隔开的日期参数,返回1970-1-1 00:00:00 UTC到指定的日期之间的毫秒数。
你应该指定一个完整格式的年份,如 1998。如果年份被指定为 0 到 99 之间,则该方法会将年份转换为 20 世纪的一个年份(即 1900 + year),例如,指定为 95, 则年份为 1995。
UTC
方法与 Date
有两点不同:
Date.UTC
方法使用协调世界时代替本地时间。Date.UTC
方法返回一个时间数值,而不是一个日期对象。如果有一个指定的参数超出其合理范围,则 UTC 方法会通过更新其他参数直到该参数在合理范围内。例如,为月份指定 15,则年份将会加 1,然后月份将会使用 3。
由于 UTC
是 Date
(日期对象)的一个静态方法,所以应该在 Date
上直接调用,就像 Date.UTC()
,而不要把它作为创建的日期对象的方法。
Date.UTC
下面的语句使用 UTC 时间代替本地时间创建了一个日期对象。
var utcDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0));
规范版本 | 规范状态 | 注解 |
---|---|---|
ECMAScript 1st Edition. Implemented in JavaScript 1.0 | Standard | Initial definition. |
{{SpecName('ES5.1', '#sec-15.9.4.3', 'Date.UTC')}} | {{Spec2('ES5.1')}} | |
{{SpecName('ES6', '#sec-date.utc', 'Date.UTC')}} | {{Spec2('ES6')}} |
{{Compat("javascript.builtins.Date.UTC")}}