UTC 方法

更新：2007 年 11 月

傳回 Coordinated Universal Time (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 之間的整數表示一月到十二月。

• day
  必要項。代表日期，以介於 1 到 31 之間的整數表示。

• hours
  選擇項。如果指定 minutes 的話，就必須指定這一項。以介於 0 到 23 之間的整數 (表示午夜到下午 11 點) 來指定小時。

• minutes
  選擇項。如果指定 seconds 的話，就必須指定這一項。以介於 0 到 59 之間的整數來指定分鐘。

• seconds
  選擇項。如果指定 milliseconds 的話，就必須指定這一項。以介於 0 到 59 之間的整數來指定秒數。

• ms
  選擇項。以介於 0 到 999 之間的整數來指定毫秒數。

備註

UTC 方法會傳回 UTC 1970 年 1 月 1 日午夜開始到指定日期之間的毫秒數。這項傳回值可以使用在 setTime 方法以及 Date 物件建構函式當中。如果引數值大於其範圍或者是負數的話，其他的儲存值都會跟著修改。例如，您若指定 150 秒，JScript 就會重新將該數字定義為 2 分 30 秒。

UTC 方法與接受日期的 Date 物件建構函式 (Constructor) 之間的差別在於：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 方法