Date.UTC()
方法接受的参数同日期构造函数接受最多参数时一样,返回从1970-1-1 00:00:00 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.
语法
Date.UTC(year,month[,date[,hrs[,min[,sec[,ms]]]]])
参数
-
year
- 1900 年后的某一年份。
-
month
- 0 到 11 之间的一个整数,表示月份。
-
date
- 1 到 31 之间的一个整数,表示某月当中的第几天。
-
hrs
- 0 到 23 之间的一个整数,表示小时。
-
min
- 0 到 59 之间的一个整数,表示分钟。
-
sec
- 0 到 59 之间的一个整数,表示秒。
-
ms
- 0 到 999 之间的一个整数,表示毫秒。
描述
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. |
ECMAScript 5.1 (ECMA-262) Date.UTC |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) Date.UTC |
Standard |
浏览器兼容性
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
UTC |
Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 3 | Opera Full support Yes | Safari Full support Yes | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support 1.0 | nodejs Full support Yes |
Legend
- Full support
- Full support