廢話不多說,先把 Date 物件最常用的取值方法列出來。
var myDate = new Date(); myDate.getYear(); // 取得當前年份(2 位) myDate.getFullYear(); // 取得完整年份(4 位,1970-????) myDate.getMonth(); // 取得當前月份(0-11,0 代表 1 月) myDate.getDate(); // 取得當前日(1-31) myDate.getDay(); // 取得當前星期(0-6,0 代表星期日) myDate.getTime(); // 取得時間戳(從 1970.1.1 起的毫秒數) myDate.getHours(); // 取得小時(0-23) myDate.getMinutes(); // 取得分鐘(0-59) myDate.getSeconds(); // 取得秒數(0-59) myDate.getMilliseconds(); // 取得毫秒(0-999) myDate.toLocaleDateString();// 取得當前日期 var mytime = myDate.toLocaleTimeString(); // 取得當前時間 myDate.toLocaleString(); // 取得日期與時間
最容易搞混的是這三個:getMonth() 從 0 開始算、getDate() 是月份中的第幾天、getDay() 是星期幾。名字相近、意義完全不同,是無數 off-by-one bug 的來源。
Date 可以說是 Web 專案中不可或缺的類別。下面這個擴充方法能讓你用熟悉的 pattern 字串輸出日期:
Date.prototype.format = function(format)
{
var o = {
"M+" : this.getMonth()+1, // month
"d+" : this.getDate(), // day
"h+" : this.getHours(), // hour
"m+" : this.getMinutes(), // minute
"s+" : this.getSeconds(), // second
"q+" : Math.floor((this.getMonth()+3)/3), // quarter
"S" : this.getMilliseconds() // millisecond
}
if(/(y+)/.test(format)) format=format.replace(RegExp.$1,
(this.getFullYear()+"").substr(4 - RegExp.$1.length));
for(var k in o) if(new RegExp("("+ k +")").test(format))
format = format.replace(RegExp.$1,
RegExp.$1.length==1 ? o[k] :
("00" + o[k]).substr(("" + o[k]).length));
return format;
}
使用方式(必須先宣告再使用):
var d = new Date().format('yyyy-MM-dd');
它的運作原理值得拆解一下:正則 /(y+)/ 抓到連續的 y,再用 substr 從四位年份中裁出對應長度,因此 yy 會得到後兩位、yyyy 得到完整四位;而 ("00" + o[k]).substr(("" + o[k]).length) 這段則是靠字串補零來達成「一位數補成兩位」的效果。技巧聰明,但也說明了一件事:日期格式化在 JavaScript 中長年是個需要自己動手的麻煩事。
JavaScript 的日期物件是 Date,那要如何把日期物件按自訂格式輸出?Date 內建了四個輸出字串的方法:
toGMTString:按 GMT 格式顯示日期。toLocaleString:按本機作業系統格式顯示。toLocaleDateString:按本機格式顯示日期部分。toLocaleTimeString:按本機格式顯示時間部分。問題是這些格式由系統決定,你無法控制。若要自訂,JsJava 提供了專用的類:引入 src/jsjava/text/DateFormat.js(或直接引入 jslib/jsjava-2.0.js),寫法如下:
var df = new SimpleDateFormat();// jsJava 1.0 需使用 DateFormat 物件,不要弄錯
df.applyPattern("yyyy-MM-dd HH:mm:ss");
var date = new Date(2007,3,30,10,59,51);
var str = df.format(date);
document.write(str);// 顯示結果為:2007-04-30 10:59:51
你只要指定 pattern,剩下的交給它。pattern 中那些字母都是佔位符,各自代表不同含義(例如 y 表示年、yyyy 表示四位數年份)。以下列出支援的特殊字元:
G Era designator Text AD y Year Year 1996; 96 M Month in year Month July; Jul; 07 w Week in year Number 27 W Week in month Number 2 D Day in year Number 189 d Day in month Number 10 F Day of week in month Number 2 E Day in week Text Tuesday; Tue a Am/pm marker Text PM H Hour in day (0-23) Number 0 k Hour in day (1-24) Number 24 K Hour in am/pm (0-11) Number 0 h Hour in am/pm (1-12) Number 12 m Minute in hour Number 30 s Second in minute Number 55 S Millisecond Number 978
這張表引自 Java 官方文件並做了些許調整。若你學過 Java 的日期格式化,這些佔位符會很熟悉;沒學過也無妨,常用的其實只有 yyyy、MM、dd、HH、mm、ss 這六個。
上面兩種方案都屬於歷史產物。現在處理日期有更好的選擇:
Date.prototype.toLocaleDateString() 搭配 Intl.DateTimeFormat,可以直接指定 locale 與各欄位格式,不必自己補零。toISOString() 與字串切片,是處理 ISO 8601 格式最乾淨的方式。另外,直接擴充 Date.prototype 這種做法在現代開發中並不鼓勵:它會污染全域原型,一旦與其他庫的實作衝突就很難排查。改成獨立函數 formatDate(date, pattern),收益遠大於成本。