DIV CSS 佈局教程網

JavaScript 實例教學(15):Date 物件的建立、讀取與設定
編輯:關於JavaScript     

Date(日期)物件用 Date() 建構器建立,前面提過,這裡專門整理它的各種用法。

四種建立方式

var today = new Date();
不給參數,回傳當前日期與時間。

var newyear = new Date("December 31, 1998 23:59:59");
傳入字串,格式為「月 日,年 小時:分鐘:秒」。

var bday = new Date(75, 1, 16);
傳入數值,依序是年、月、日。

var bday = new Date(75, 1, 16, 12, 0, 0);
再加上時、分、秒。

這裡有個大坑:月份從 0 開始。一月是 0,二月是 1,以此類推到十二月是 11。所以 new Date(75, 1, 16) 其實是 2 月 16 日,不是 1 月。這個設計至今仍在,是 JavaScript 裡最容易出錯的 API 之一。

讀取方法(getter)

getYear() 回傳年份。注意它回傳的是「1900 年之後的差值」,所以 2001 年會回傳 101——這是被詬病多年的設計,請改用 getFullYear()。

getMonth() 回傳月份(0 到 11)。getDate() 回傳月份中的第幾日(1 到 31)。getDay() 回傳星期幾(0 到 6,0 是週日)。這三個名字太像,很容易搞混。

getTimezoneOffset() 回傳本地時間與 UTC 的差值(以分鐘計)。台灣是 UTC+8,所以回傳 -480。要注意某些舊版 IE 的符號是反的。

getHours()(0–23)、getMinutes()(0–59)、getSeconds()(0–59)分別取時、分、秒。

getTime() 回傳自 1970 年 1 月 1 日 UTC 以來的毫秒數,也就是所謂的 timestamp。

設定方法(setter)

setDate()、setHours()、setMinutes()、setMonth()、setSeconds()、setTime()、setYear() 與各自的 getter 一一對應,參數範圍也相同。呼叫方式如下:

var nextYear = new Date();
nextYear.setYear(nextYear.getYear() + 1);

同樣建議把 setYear 換成 setFullYear。

轉換與其他方法

parse 把日期字串轉為毫秒數,寫成 Date.parse("date string")。

toString() 回傳類似 Sat Jun 2 16:08:24 UTC+0800 2001 的字串。

toGMTString() 回傳 Sat, 2 Jun 2001 08:08:24 UTC 這樣的標準格式。

toLocaleString() 回傳依地區設定的格式,例如 2001年6月2日 16:08:24。

這些方法都作用於獨立的日期物件。有 Java 背景的人可以把它們想成 Date 類的公開方法。

要特別說明的是,parse 是 Date 這個建構器本身的靜態方法,不是某個日期變數的方法。所以必須寫 Date.parse(...),不能寫 somedate.parse(...)。

今天該知道的補充

上述 API 大多已被標記為 legacy。實務上的建議是:內部一律用 timestamp 或 Date 物件運算,只在要顯示或解析時才轉字串;若要格式化輸出,用 Intl.DateTimeFormat 會自動處理地區差異;若要處理時區(例如使用者在不同國家),date-fns 或 Temporal 這類函式庫能省下大量踩坑時間。

另外,toGMTString() 已改名為 toUTCString(),而 ISO 8601 格式的字串(例如 "2026-08-19T15:50:00Z")是唯一能可靠被 Date 解析的格式,其他寫法在各瀏覽器上的結果並不一致。

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