MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Date.UTC() 方法接受與建構子相同長度的參數,將參數視為通用時間(UTC)來計算回傳由 1970-01-01 00:00:00 UTC 所經過的毫秒數。

格式

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

參數

year
1900 年後的年份。
month
月份,介於 0 到 11 之間。
day
選用。月份中的日期,介於  1 到 31 之間。
hour
選用。小時,介於 0 到 23 之間。
minute
選用。分鐘數,介於 0 到 59 之間。
second
選用。秒數,介於 0 到 59 之間。
millisecond
選用。毫秒數 0 到 999 之間。

回傳值

得到傳入這個 Date 方法的參數所代表時間,與 1970-01-01 00:00:00 UTC 相差的毫秒數。

描述

UTC() 取得以逗號分隔的時間參數,回傳 1970-01-01 00:00:00 UTC 與該時間相差的毫秒數。

你應該指定完成的年份資料,例如: 1998。如果一個 0 到 99 的年份被指定,這個方法會將它轉換為 20 世紀的年份(變為 19xx 年),例如你傳入 95 ,則會被當作 1995 年被指定。

這個 UTC() 方法與 Date 建構子有兩個地方不同。

  • Date.UTC() 使用 UTC 時區而不是當地時區。
  • Date.UTC() 回傳一個數值而不是 Date 物件。

當你指定參數超出預期的範圍, UTC( ) 方法會去調整其它的參數使之成立。比如如果你指定月份為 15 ,年份將被加 1 ,以 3 作為傳入的月份。

因為 UTC( ) 是 Date 的一個靜態方法,只能使用 Date.UTC() 的方式呼叫,而不能由建立出來的 Date 物件去執行它。

範例

使用 Date.UTC()

以下利用它來將指定的時間以 UTC 而非本地時間的方式來建立  Date 物件:

var utcDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0));

規範

規範 狀態
ECMAScript 2017 Draft (ECMA-262)
The definition of 'Date.UTC' in that specification.
Draft  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Date.UTC' in that specification.
Standard  
ECMAScript 5.1 (ECMA-262)
The definition of 'Date.UTC' in that specification.
Standard  
ECMAScript 1st Edition (ECMA-262) Standard 初始定義。
實作在 JavaScript 1.0.

瀏覽器相容性

平台 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本支援 (Yes) (Yes) (Yes) (Yes) (Yes)
平台 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本支援 ? ? ? ? ? ?

相關資源

文件標籤與貢獻者

 此頁面的貢獻者: ddtet
 最近更新: ddtet,