大网数据广告活动
Web 标准与前端开发

Date.UTC()

· 52CE 我爱测

**`Date.UTC()`** 方法接受的参数同 Date 构造函数接受最多参数时一样,但该前者会视它们为 UTC 时间,其返回从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的毫秒数。

Date.UTC() 方法接受的参数同 Date 构造函数接受最多参数时一样,但该前者会视它们为 UTC 时间,其返回从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的毫秒数。

JavaScript Demo: Date.UTC()

const utcDate1 = new Date(Date.UTC(96, 1, 2, 3, 4, 5));
const utcDate2 = new Date(Date.UTC(0, 0, 0, 0, 0, 0));

console.log(utcDate1.toUTCString());
// Expected output: "Fri, 02 Feb 1996 03:04:05 GMT"

console.log(utcDate2.toUTCString());
// Expected output: "Sun, 31 Dec 1899 00:00:00 GMT"

语法

Date.UTC(year)
Date.UTC(year, month)
Date.UTC(year, month, day)
Date.UTC(year, month, day, hour)
Date.UTC(year, month, day, hour, minute)
Date.UTC(year, month, day, hour, minute, second)
Date.UTC(year, month, day, hour, minute, second, millisecond)

参数

  • year

    • : 一个表示年份的整数值。

      从 0 到 99 的值会被映射到 1900 至 1999 年。其他的值则代表实际的年份。参见示例。

  • month

    • : 0(一月)到 11(十二月)之间的一个整数,表示月份。从 ECMAScript 2017 开始,如果忽略该值,则默认为 0。(直到 ECMAScript 2016,month 都是必须的参数。而从 ES2017 开始,它不再是必须的。)
  • date

    • : 1 到 31 之间的一个整数,表示某月当中的第几天。如果忽略该值,则默认为 1。
  • hour

    • : 0 到 23 之间的一个整数,表示小时。如果忽略该值,则默认为 0。
  • minute

    • : 0 到 59 之间的一个整数,表示分钟。如果忽略该值,则默认为 0。
  • second

    • : 0 到 59 之间的一个整数,表示秒。如果忽略该值,则默认为 0。
  • millisecond

    • : 0 到 999 之间的一个整数,表示毫秒。如果忽略该值,则默认为 0。

返回值

一个数字,表示从 1970 年 1 月 1 日 00:00:00 UTC 到给定时间的毫秒数。

描述

UTC() 方法接受以逗号隔开的时间参数,返回 1970 年 1 月 1 日 00:00:00 UTC 到指定的时间之间的毫秒数。

如果年份被指定为 0 到 99 之间,则该方法会将年份转换为 20 世纪的一个年份(即 1900 + year),例如,指定为 95,则年份为 1995。

UTC() 方法与 Date 构造函数有两点不同:

  1. Date.UTC() 方法使用协调世界时代替本地时间。
  2. Date.UTC() 方法返回一个时间数值,而不是一个 Date 对象。

如果有一个指定的参数超出其合理范围,则 UTC 方法会通过更新其他参数直到该参数在合理范围内。例如,为月份指定 15,则年份将会加 1(year + 1),然后月份将会使用 3。

由于 UTC() 是 Date 的一个静态方法,所以应该直接调用 Date.UTC(),而不要把它作为 Date 实例的方法。

示例

使用 Date.UTC()

下面的语句使用 UTC 时间代替本地时间创建了一个 Date 对象。

const utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0));

规范

浏览器兼容性

兼容性备注

少于两个参数的 Date.UTC()

当向 Date.UTC() 提供少于两个的参数时,ECMAScript 2017 要求返回 NaN。不支持此行为的引擎已被更新(参见 bug 1050755、ecma-262 #642)。

Date.UTC();
Date.UTC(1);

// Safari: NaN
// Chrome/Opera/V8: NaN

// Firefox <54: non-NaN
// Firefox 54+: NaN

// IE: non-NaN
// Edge: NaN

参见

  • Date.parse()
  • Date

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。