UTC 方法

傳回 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 物件。

範例

下列範例說明如何使用 UTC 方法。

function DaysBetweenDateAndNow(yr, mo, dy)
{
    // Determine the milliseconds per day.
    var MinMilli = 1000 * 60
    var HrMilli = MinMilli * 60
    var DyMilli = HrMilli * 24

    // Determine today's UTC year, month, and day.
    var d = new Date();
    var yeartoday = d.getUTCFullYear();
    var monthtoday = d.getUTCMonth();
    var dayofmonthtoday = d.getUTCDate();
    
    // Get the milliseconds since 1/1/1970 UTC.
    var t1 = Date.UTC(yr, mo - 1, dy)
    var t2 = Date.UTC(yeartoday, monthtoday, dayofmonthtoday);
   
    // Determine the difference in days.
    var days = (t1 - t2) / DyMilli;
   
    return(days);
}

需求

1 版

套用至:

Date 物件

請參閱

參考

setTime 方法