Date 物件是 JavaScript 處理日期與時間的核心工具。這篇文章把它的取用、設置與各類方法做個完整梳理。
一、取得日期相關數值
- Date():回傳當日的日期與時間。
- getDate():回傳月份中的某一天(1~31)。
- getDay():回傳一週中的某一天(0~6,0 代表週日)。
- getMonth():回傳月份(0~11,注意從 0 起算)。
- getFullYear():以四位數字回傳年份。
- getYear():請改用 getFullYear()。
- getHours():回傳小時(0~23)。
- getMinutes():回傳分鐘(0~59)。
- getSeconds():回傳秒數(0~59)。
- getMilliseconds():回傳毫秒(0~999)。
- getTime():回傳 1970 年 1 月 1 日至今的毫秒數。
二、設置日期相關數值
- setDate():設置月份中的某一天(1~31)。
- setMonth():設置月份(0~11)。
- setFullYear():設置四位數字的年份。
- setHours():設置小時(0~23)。
- setMinutes():設置分鐘(0~59)。
- setSeconds():設置秒數(0~59)。
- setMilliseconds():設置毫秒(0~999)。
- setTime():以毫秒設置整個 Date 物件。
建立 Date 物件
語法很簡單:
var myDate = new Date();
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(0 是 1 月,11 是 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);
三、Date 物件方法總覽
以下把常用方法一次列出,方便查閱:
- Date():回傳當日日期與時間。
- getDate() / getDay() / getMonth() / getFullYear():分別取得日、星期、月、年。
- getHours() / getMinutes() / getSeconds() / getMilliseconds():取得時、分、秒、毫秒。
- getTime():回傳 1970/1/1 至今的毫秒數。
- getTimezoneOffset():回傳本地時間與 GMT 的分鐘差。
- getUTCDate() / getUTCDay() / getUTCMonth() / getUTCFullYear():依世界時取得日、星期、月、年。
- getUTCHours() / getUTCMinutes() / getUTCSeconds() / getUTCMilliseconds():依世界時取得時、分、秒、毫秒。
- parse():回傳 1970/1/1 午夜到指定日期字串之間的毫秒數。
- setDate() / setMonth() / setFullYear():設置日、月、年。
- setHours() / setMinutes() / setSeconds() / setMilliseconds():設置時、分、秒、毫秒。
- setTime():以毫秒設置 Date 物件。
- setUTCDate() / setUTCMonth() / setUTCFullYear():依世界時設置日、月、年。
- setUTCHours() / setUTCMinutes() / setUTCSeconds() / setUTCMilliseconds():依世界時設置時、分、秒、毫秒。
- toSource():回傳該物件的原始碼。
- toString():把 Date 物件轉成字串。
- toTimeString():把時間部分轉成字串。
- toDateString():把日期部分轉成字串。
- toGMTString():請改用 toUTCString()。
- toUTCString():依世界時把 Date 物件轉成字串。
- toLocaleString():依本地時間格式轉成字串。
- toLocaleTimeString():依本地格式轉出時間部分。
- toLocaleDateString():依本地格式轉出日期部分。
- UTC():依世界時回傳 1970/1/1 到指定日期的毫秒數。
- valueOf():回傳 Date 物件的原始值。
把這張清單收藏起來,日後處理日期相關需求時就能快速對照使用。