建立 Date 對象的語法
// Date 對象會自動把當前日期和時間保存為其初始值 new Date(); // value 為毫秒:代表自世界協調時 1970 年 1 月 1 日 00:00:00 開始的數值 new Date(value); // dateString 為日期字串:表示日期的字串值,需為 parse 方法能識別的格式 new Date(dateString); // year 為年份(建議用 4 位數,避免 2000 年問題,用 1998 而非 98) // month 為月份,從 0(1 月)到 11(12 月) // day 為一個月中的第幾天,從 1 開始 // hour、minute、second、millisecond 分別為時、分、秒、毫秒 new Date(year, month, day [, hour, minute, second, millisecond]);
Date()
Date() 方法可回傳當天的日期和時間。
console.log(Date()); // "Tue Sep 17 2013 12:22:55 GMT+0800 (中國標準時間)"
parse()
parse() 可解析一個日期時間字串,並回傳 1970/1/1 午夜距該日期時間的毫秒數。參數 datestring 為必需,表示日期和時間的字串。此方法是 Date 對象的靜態方法,一般以 Date.parse() 形式呼叫。
console.log(Date.parse(Date())); // 1379392301000
console.log(Date.parse("Aug 9, 1995"));// 807897600000
UTC()
UTC() 可根據世界時回傳 1970 年 1 月 1 日到指定日期的毫秒數。year(四位數)與 month(0~11)為必需,day(1~31)、hours(0~23)、minutes(0~59)、seconds(0~59)、ms(0~999)為可選。它是靜態方法,參數均為 UTC 時間,處於 GMT 時區。
ECMAScript 中的 Date 類型建立在早期 Java 的 java.util.Date 類基礎上,使用自 UTC 1970 年 1 月 1 日午夜起算的毫秒數來保存日期,精度可達 1970 年前後約 285616 年。
注意:parse() 的日期和時間基於本地時區建立,而 UTC() 基於 GMT 建立,兩者參數也不同。GMT 即世界時,是格林尼治所在地的標準時間。
var d = new Date(); console.log(Date.parse(d)); // 1379393562000 console.log(Date.UTC(d.getFullYear(), d.getMonth(), d.getDate(), d.getHours(), d.getMinutes(), d.getSeconds(), d.getMilliseconds())); // 1379422362020
ECMAScript 5 添加了 Date.now() 方法,回傳呼叫當下的毫秒數(IE9 起支援)。我們也能用 + 運算符把 Date 對象轉成數值以得到相同結果:
var d1 = Date.now(); var d2 = +new Date(); console.log(d1); // 1379393793104 console.log(d2); // 1379393793104
JavaScript 的日期轉換頗為微妙,會因參數不同而有不同結果,各瀏覽器表現也有差異:
var d1 = new Date("2012/03/13");
var d2 = new Date("2012-03-13");
var d3 = new Date("2012-3-13");
console.log(d1); // Tue Mar 13 2012 00:00:00 GMT+0800 (中國標準時間)
console.log(d2); // Tue Mar 13 2012 08:00:00 GMT+0800 (中國標準時間)
console.log(d3); // Tue Mar 13 2012 00:00:00 GMT+0800 (中國標準時間)
為避免這些問題,建議:堅持使用 "YYYY/MM/DD" 格式;避免使用帶連字號的 "YYYY-MM-DD";指定四位數年份;由於 Chrome 能接受的日期字串比其他瀏覽器更多,在 Chrome 沒問題不代表其他瀏覽器沒問題。
get 系列方法
getDate():取得一個月中的某天(1~31);getDay():取得一周中的某天(0~6);getMonth():取得月份(0~11);getFullYear():以四位數取得年份(勿用 getYear());getHours():小時(0~23);getMinutes():分鐘(0~59);getSeconds():秒(0~59);getMilliseconds():毫秒(0~999);getTime():1970 年 1 月 1 日至今的毫秒數;getTimezoneOffset():本地時間與 GMT 的分鐘差;getUTCDate()、getUTCDay()、getUTCMonth()、getUTCFullYear()、getUTCHours()、getUTCMinutes()、getUTCSeconds()、getUTCMilliseconds():則是根據世界時取得對應的數值。
set 系列方法
setDate():設定月中的某天(1~31);setMonth():設定月份(0~11);setFullYear():設定四位數年份(勿用 setYear());setHours():小時(0~23);setMinutes():分鐘(0~59);setSeconds():秒(0~59);setMilliseconds():毫秒(0~999);setTime():以毫秒設定 Date 對象;對應的 setUTCDate()、setUTCMonth()、setUTCFullYear()、setUTCHours()、setUTCMinutes()、setUTCSeconds()、setUTCMilliseconds() 則根據世界時設定。
toString 系列方法
toString():把 Date 對象轉為字串,總是回傳美式英語表達的字串;toTimeString():轉為時間部分的字串;toDateString():轉為日期部分的字串;toUTCString():根據世界時轉為字串;toLocaleString():根據本地時間格式轉為字串;toLocaleTimeString() 與 toLocaleDateString() 則分別轉為本地時間與日期部分。
var d = new Date(); console.log(d); // Tue Sep 17 2013 13:37:04 GMT+0800 (中國標準時間) console.log(d.toTimeString()); // 13:37:04 GMT+0800 (中國標準時間) console.log(d.toDateString()); // Tue Sep 17 2013 console.log(d.toUTCString()); // Tue, 17 Sep 2013 05:37:04 GMT console.log(d.toLocaleString()); // 2013年9月17日 下午1:37:04 console.log(d.toLocaleTimeString()); // 下午1:37:04 console.log(d.toLocaleDateString()); // 2013年9月17日
toLocaleString() 系列方法可接收參數來決定輸出的習慣格式:
var d = new Date();
console.log(d.toLocaleString("ko-KR")); // 2013년 9월 17일 오후 1:48:24