Date.UTC()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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 物件:

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

規範

Specification
ECMAScript® 2025 Language Specification
# sec-date.utc

瀏覽器相容性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
UTC
monthIndex defaults to 0

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

相關資源