DIV CSS 佈局教程網

JavaScript Date 物件方法全解析:解析、格式化與各級組件
編輯:關於JavaScript     

Date 的底層設計

ECMAScript 的 Date 型別建構在早期 Java 的 java.util.Date 類別概念之上,內部用「自 UTC(Coordinated Universal Time,國際協調時間)1970 年 1 月 1 日午夜起算的毫秒數」來保存日期。在這種儲存格式下,Date 能精確表達 1970 年前後各約 285616 年的範圍——遠比一般應用需要的跨度大得多。

這個設計有個實務含意:Date 內部一律以 UTC 毫秒數運算,只有在你呼叫 getHours() 這類「本地時間」方法時才做時區換算。理解這點,就能解釋為什麼同一個時間戳在不同時區顯示會不同。

靜態方法:把輸入變成毫秒數

Date.parse(string):接受表示日期的字串,嘗試轉為對應的毫秒數,無法轉換則回傳 NaN。

Date.UTC(year, month[, day, hour, min, second, millisecond]):依參數回傳毫秒數。只有前兩個參數(年、月)是必填,其餘省略時一律視為 0。注意月份從 0 起算。

Date.now():回傳呼叫當下的毫秒數,比 +new Date() 更直觀。

繼承自 Object 的方法

toLocaleString():依瀏覽器地區設定輸出日期與時間,格式因瀏覽器而異。

toString():通常回傳含時區資訊的字串,時間多以 24 小時制表示,格式同樣因瀏覽器而異。

valueOf():回傳毫秒數,這也是 date1 - date2 能直接相減的原因。

格式化輸出

toDateString():顯示星期、月、日、年。

toTimeString():顯示時、分、秒與時區。

toLocaleDateString():以地區格式顯示星期、月、日、年。

toLocaleTimeString():以地區格式顯示時、分、秒。

toUTCString():輸出完整的 UTC 日期字串。

另外還有 ES5 之後加入的 toISOString(),輸出標準的 YYYY-MM-DDTHH:mm:ss.sssZ,跨語言交換資料時最可靠。

日期/時間組件的讀取與設定

以下成對出現的 getter/setter 用來存取日期中特定部位的值:

getTime() / setTime(毫秒):讀取或設定毫秒數。setTime 會改動整個日期。

getFullYear() / setFullYear(年):四碼年份(如 2007 而非 07)。傳入必須是四位數。

getUTCFullYear() / setUTCFullYear(年):UTC 版本的四碼年份。

getMonth() / setMonth(月):月份 0 代表一月,11 代表十二月。

getUTCMonth() / setUTCMonth(月):UTC 版本的月份。

getDate() / setDate(日):月份中的第幾天(1–31)。若傳入值超出該月天數,會自動進位到下個月。

getUTCDate() / setUTCDate(日):UTC 版本,同樣會自動進位。

getDay() / getUTCDay():星期幾,0 為週日,6 為週六。注意這組沒有對應的 setter。

getHours() / setHours(時):小時 0–23,超出 23 則進位到天。

getUTCHours() / setUTCHours(時):UTC 版本。

getMinutes() / setMinutes(分):分鐘 0–59,超出則進位到小時。

getUTCMinutes() / setUTCMinutes(分):UTC 版本。

getSeconds() / setSeconds(秒):秒數 0–59,超出則進位到分鐘。

getUTCSeconds() / setUTCSeconds(秒):UTC 版本。

getMilliseconds() / setMilliseconds(毫秒):毫秒部分。

getUTCMilliseconds() / setUTCMilliseconds(毫秒):UTC 版本。

getTimezoneOffset():回傳本地時間與 UTC 相差的分鐘數。台灣屬 UTC+8,因此回傳 -480。

實務上最常踩的兩個坑

一是月份從 0 開始。new Date(2026, 8, 26) 得到的是九月而非八月。

二是字串解析沒有統一標準。new Date("2026-08-26") 在 ES5 之後被定義為 UTC 午夜,而 new Date("2026/08/26") 則是本地時間午夜——在 UTC+8 的環境下,兩者會相差八小時,甚至落在不同日期。處理使用者輸入時,建議一律手動拆字串再組 Date,或直接使用 Date.parse 搭配明確格式。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved