UTC 方法

更新：2007 年 11 月

返回协调通用时间 (UTC)（或 GMT）1970 年 1 月 1 日午夜与所提供的日期之间相差的毫秒数。

function UTC(year : Number , month : Number , day : Number [, hours : Number [, minutes : Number [, seconds : Number [,ms : Number]]]]) : Number

参数

• year
  必选。为了确保跨世纪日期的精确性，需要指定完整的年份。如果 year 处于 0 到 99 之间，那么 year 就被假定为 1900 + year。

• month
  必选。月份，用从 0 到 11 的整数表示（1 月至 12 月）。

• 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;            //Declare variables.
   var MinMilli = 1000 * 60         //Initialize variables.
   var HrMilli = MinMilli * 60
   var DyMilli = HrMilli * 24
   t1 = Date.UTC(yr, mo - 1, dy)    //Get milliseconds since 1/1/1970.
   d = new Date();                  //Create Date object.
   t2 = d.getTime();                //Get current time.
   if (t2 >= t1) 
      t3 = t2 - t1;
   else
      t3 = t1 - t2;
   r = Math.round(t3 / DyMilli);
   return(r);                       //Return difference.
}

要求

版本 1

应用于：

Date 对象

请参见

参考

setTime 方法