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));
規範
瀏覽器相容性
平台 | 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 |
---|---|---|---|---|---|---|
基本支援 | ? | ? | ? | ? | ? | ? |