日期與時間的處理是 JavaScript 開發中經常碰到的課題。本文把 Date 物件的常用方法系統性地整理出來,方便隨時查閱。
1. Date()——返回當日的日期與時間。
2. getDate()——從 Date 物件返回一個月中的某一天(1 ~ 31)。
3. getDay()——從 Date 物件返回一週中的某一天(0 ~ 6)。
4. getMonth()——從 Date 物件返回月份(0 ~ 11)。
5. getFullYear()——從 Date 物件以四位數字返回年份。
6. getYear()——請改用 getFullYear() 取代。
7. getHours()——返回 Date 物件的小時(0 ~ 23)。
8. getMinutes()——返回 Date 物件的分鐘(0 ~ 59)。
9. getSeconds()——返回 Date 物件的秒數(0 ~ 59)。
10. getMilliseconds()——返回 Date 物件的毫秒(0 ~ 999)。
11. getTime()——返回 1970 年 1 月 1 日至今的毫秒數。
1. setDate()——設置 Date 物件中月的某一天(1 ~ 31)。
2. setMonth()——設置 Date 物件中的月份(0 ~ 11)。
3. setFullYear()——設置 Date 物件中的年份(四位數字)。
4. setHours()——設置 Date 物件中的小時(0 ~ 23)。
5. setMinutes()——設置 Date 物件中的分鐘(0 ~ 59)。
6. setSeconds()——設置 Date 物件中的秒鐘(0 ~ 59)。
7. setMilliseconds()——設置 Date 物件中的毫秒(0 ~ 999)。
8. setTime()——以毫秒設置 Date 物件。
建立 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:以整數表示月份,從 0 到 11(1 月到 12 月)。
dd:表示一個月中的第幾天,從 1 到 31。
yyyy:四位數表示的年份。
hh:小時數,從 0(午夜)到 23(晚 11 點)。
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);
getTimezoneOffset() 返回本地時間與格林威治標準時間(GMT)的分鐘差。
getUTCDate()/getUTCDay()/getUTCMonth()/getUTCFullYear() 等 UTC 系列方法,根據世界時返回對應的日期、星期、月份與年份。
getUTCHours()/getUTCMinutes()/getUTCSeconds()/getUTCMilliseconds() 則根據世界時返回時、分、秒與毫秒。
parse() 返回 1970 年 1 月 1 日午夜到指定日期(字串)的毫秒數。
setUTCDate() 等 UTC 系列方法,根據世界時設置對應的日期、月份、年份、時、分、秒與毫秒。
toSource() 返回該物件的原始碼;toString() 把 Date 物件轉為字串。
toTimeString() 把時間部分轉為字串;toDateString() 把日期部分轉為字串。
toGMTString() 請改用 toUTCString(),後者根據世界時把 Date 物件轉為字串。
toLocaleString()/toLocaleTimeString()/toLocaleDateString() 根據本地時間格式,把 Date 物件(或其時間、日期部分)轉為字串。
UTC() 根據世界時返回 1970 年 1 月 1 日到指定日期的毫秒數;valueOf() 返回 Date 物件的原始值。
掌握這些方法,就能應付絕大多數日期與時間的讀取、設置與格式化需求了。