DIV CSS 佈局教程網

JavaScript Date 的參數怎麼傳:Date.parse 與 Date.UTC 的差別
編輯:JavaScript綜合知識     

建立日期物件看似簡單,但一旦要指定時間,就會遇到時區與參數格式的問題。本文釐清 Date 建構子的參數規則,以及 Date.parse() 與 Date.UTC() 的關鍵差異。

不傳參數:取當前時間

var now = new Date();

不傳任何參數時,物件會自動取得目前的日期與時間。

傳參數:必須是毫秒數

若要建立自訂時間的物件,傳給 Date() 的參數必須是毫秒數——從 UTC 時間 1970 年 1 月 1 日午夜起到目標時間為止的累計毫秒數。

取得這個毫秒數有兩個輔助方法:

Date.parse()

接收一個表示日期的字串,例如 "May 25, 2013"、"6/13/2013" 等格式。要注意的是,支援的格式因瀏覽器與地區而異,這也是字串解析經常出問題的原因。較保險的做法是使用 ISO 8601 格式("2013-12-12" 或 "2013-12-12T10:30:00Z")。

Date.UTC()

依序接收:年份、月份(從 0 開始,0–11)、日(1–31)、小時(0–23)、分鐘、秒、毫秒。其中年份與月份是必填,其餘預設為 0。

實例:建立 2013 年 12 月 12 日

用 Date.parse():

var mydate = new Date(Date.parse("12/12/2013"));

也可以直接傳字串:

var mydate = new Date("12/12/2013");

此時建構 Date 的過程中會自動呼叫 Date.parse() 把字串轉為毫秒數。

用 Date.UTC():

var mydate = new Date(Date.UTC(2013, 11, 12));
// 注意:月份索引從 0 開始,所以 11 代表 12 月;日的索引則從 1 開始

同樣地,直接傳數值也會自動呼叫 Date.UTC():

var mydate = new Date(2013, 11, 12);

最關鍵的差異:UTC 還是本地時間

這兩種寫法看起來只差一層呼叫,結果卻不同:

  • new Date(Date.UTC(2013, 11, 12)) → 得到的是 GMT(UTC)時間。換算成本地時間顯示時,會依時區偏移而落在不同的日期或時刻。
  • new Date(2013, 11, 12) → 得到的是依系統設定的本地時間。

在台灣(UTC+8)執行時,前者印出來的本地時間會是 2013/12/12 早上 08:00,而後者是 2013/12/12 00:00。這個八小時的落差,是跨時區功能出錯的常見根源。

實務建議

  • 月份永遠記得減一:JS 的月份從 0 算起,聖誕節是 11 月而非 12 月。
  • 後端傳時間戳時留意位數:Java 的 13 位毫秒可直接給 new Date();PHP 的 10 位秒數需先乘以 1000。
  • 顯示與運算分開處理:內部一律以 UTC 或時間戳保存,只在顯示給使用者時轉成本地時間,可避免絕大多數時區問題。
  • 考慮 Temporal 或函式庫:Date 的 API 設計在時區處理上出了名地難用,dayjs、date-fns、Luxon 等函式庫能省下不少心力。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved