UTC 方法

返回全球标准时间 (UTC) (或 GMT) 的 1970 年 1 月 1 日到所指定日期之间所间隔的毫秒数。

Date.UTC(year, month, day[, hours[, minutes[, seconds[,ms]]]])

参数

year

必选项。为了获得跨世纪日期处理的精确性，需要使用完整的年份表示法。如果 year 处于 0 到 99 之间，那么 year 就被假定为 1900 + year。

month

必选项。月份是一个处于 0 到 11 之间的整数 (一月到十二月)。

day

必选项。日期是一个处于 1 到 31 之间的整数。

hours

可选项。如果提供了 minutes，那么此项也必须提供。0 到 23 之间的一个整数 (午夜到 11pm)，用来指定小时。

minutes

可选的，如果提供了 seconds，那么此项也必须提供。 0 到 59 之间的一个整数，用来指定分钟值。

seconds

可选项。如果提供了 milliseconds，那么此项也必须提供。从 0 到 59 之间的一个整数，用来指定秒钟值。

ms

可选项。从 0 到 999 之间的一个整数，用来指定毫秒数。

说明

UTC 方法返回从 UTC 的 1970 年 1 月 1 日午夜到所指定日期之间的毫秒数。这个返回值可以用在 setTime 方法中和 Date 对象的构造函数中。如果一个参数的值超出其范围或者是一个负数，那么其他保存过的值将相应地得到改变。例如，如果使用者指定 150 秒，JScript 会将该数值重新定义为 2 分钟 30 秒。

UTC 方法和 Date 对象的接受日期值的构造函数之间的差别在于： UTC 方法假设 UTC，而 Date 对象的构造函数假定本地时间。

UTC 方法是一个静态方法。因此，Date 对象不一定要在创建完之后才可以使用。

注意   如果 year 处于 0 到 99 之间，年份为 1900 + year 。

示例

下面这个例子说明了 UTC 方法的用法：

function DaysBetweenDateAndNow(yr, mo, dy){
   var d, r, t1, t2, t3;            // 声明变量。
   var MinMilli = 1000 * 60         // 初始化变量。
   var HrMilli = MinMilli * 60
   var DyMilli = HrMilli * 24
   t1 = Date.UTC(yr, mo - 1, dy)    // 获取从 1/1/1970 开始的毫秒数。
   d = new Date();                  // 创建 Date 对象。
   t2 = d.getTime();                // 获取当前时间。
   if (t2 >= t1) 
      t3 = t2 - t1;
   else
      t3 = t1 - t2;
   r = Math.round(t3 / DyMilli);
   return(r);                       // 返回差。
}

要求

版本 1

请参阅

Date 对象的方法 | setTime 方法

应用于： Date 对象