Date 物件專門處理日期與時間。最基本的建立方式如下,不帶參數時會自動以「現在」作為初始值:
var myDate = new Date();
new Date("month dd,yyyy hh:mm:ss");
new Date("month dd,yyyy");
new Date(yyyy, mth, dd, hh, mm, ss);
new Date(yyyy, mth, dd);
new Date(ms);
最後一種要特別留意:參數是「該時刻與 GMT 1970 年 1 月 1 日相差的毫秒數」。
各參數含義:
month:英文月份名稱,January 到 December。
mth:整數月份,1 到 12。
dd:當月第幾天,1 到 31。
yyyy:四位數年份。
hh:小時,0(午夜)到 23。
mm:分鐘,0 到 59。
ss:秒數,0 到 59。
ms:毫秒,大於等於 0 的整數。
實際寫法:
new Date("January 12,2006 22:19:35");
new Date("January 12,2006");
new Date(2006, 0, 12, 22, 19, 35);
new Date(2006, 0, 12);
new Date(1137075575000);
注意第三、四行的月份參數是 0 起始的,0 代表一月——這也是最容易搞錯的地方之一。
Date() 回傳當日日期與時間。
getDate() 月中的一天(1~31)。
getDay() 週中的一天(0~6)。
getMonth() 月份(0~11)。
getFullYear() 四位數年份。
getYear() 請改用 getFullYear()。
getHours() 小時(0~23)。
getMinutes() 分鐘(0~59)。
getSeconds() 秒(0~59)。
getMilliseconds() 毫秒(0~999)。
getTime() 1970 年 1 月 1 日至今的毫秒數。
getTimezoneOffset() 本地時間與 GMT 的分鐘差。
getUTCDate() 依世界時取月中的一天(1~31)。
getUTCDay() 依世界時取週中的一天(0~6)。
getUTCMonth() 依世界時取月份(0~11)。
getUTCFullYear() 依世界時取四位數年份。
getUTCHours() 依世界時取小時(0~23)。
getUTCMinutes() 依世界時取分鐘(0~59)。
getUTCSeconds() 依世界時取秒(0~59)。
getUTCMilliseconds() 依世界時取毫秒(0~999)。
parse() 回傳 1970 年 1 月 1 日午夜到指定日期字串之間的毫秒數。
setDate() 設定月中的一天(1~31)。
setMonth() 設定月份(0~11)。
setFullYear() 設定四位數年份。
setYear() 請改用 setFullYear()。
setHours() 設定小時(0~23)。
setMinutes() 設定分鐘(0~59)。
setSeconds() 設定秒(0~59)。
setMilliseconds() 設定毫秒(0~999)。
setTime() 以毫秒設定整個 Date 物件。
setUTCDate() 依世界時設定月中的一天。
setUTCMonth() 依世界時設定月份。
setUTCFullYear() 依世界時設定四位數年份。
setUTCHours() 依世界時設定小時。
setUTCMinutes() 依世界時設定分鐘。
setUTCSeconds() 依世界時設定秒。
setUTCMilliseconds() 依世界時設定毫秒。
toSource() 回傳該物件的原始碼。
toString() 把 Date 轉為字串。
toTimeString() 只轉時間部分。
toDateString() 只轉日期部分。
toGMTString() 請改用 toUTCString()。
toUTCString() 依世界時轉為字串。
toLocaleString() 依本地時間格式轉為字串。
toLocaleTimeString() 依本地格式轉時間部分。
toLocaleDateString() 依本地格式轉日期部分。
UTC() 依世界時回傳 1970 年 1 月 1 日到指定日期的毫秒數。
valueOf() 回傳 Date 物件的原始值。
一般寫法為 var objDate = new Date([arguments list]);。實務上處理跨時區資料時,建議一律以 UTC 方法存取,最後顯示時再轉成本地時間,能避開大量 DST 相關的難題。