Date 物件只提供了 getDate()、getMinutes() 等取得單一元素的方法,並沒有直接轉為特定字串格式的功能,因此實務上往往需要自行封裝格式化函式。本文從原理到實作完整解析這項技巧。
常見做法有兩種:一是擴充 Date.prototype,讓格式化方法猶如原生方法般呼叫;二是撰寫獨立的函式。擴充原型雖方便,卻有「入侵」原型的疑慮,設計 API 時值得斟酌。
傳統的字串拼接雖能實現,但效率與可讀性都不理想,引入正規表達式才是恰當之舉。以下先欣賞來自 Steven Levithan 的完整版本:
dateFormat = (function(){
var token
= /d{1,4}|m{1,4}|yy(?:yy)?|([HhMsTt])\1?|[LloSZ]|"[^"]*"|'[^']*'/g,
timezone
= /\b(?:[PMCEA][SDP]T|(?:Pacific|Mountain|Central|Eastern|Atlantic) (?:Standard|Daylight|Prevailing) Time|(?:GMT|UTC)(?:[-+]\d{4})?)\b/g,
timezoneClip = /[^-+\dA-Z]/g,
pad
= function (val, len){
val = String(val);
len = len || 2;
while (val.length < len) val = "0" + val;
return val;
};
// Regexes and supporting functions are cached through closure
return function (date, mask, utc) {
var i18n = dateFormat.i18n;
var masks = dateFormat.masks;
if (arguments.length == 1 && Object.prototype.toString.call(date) == "[object String]" && !/\d/.test(date)) {
mask = date;
date = undefined;
}
date = date ? new Date(date) : new Date;
if (isNaN(date)) throw SyntaxError("invalid date");
mask = String(masks[mask] || mask || masks["default"]);
if (mask.slice(0, 4) == "UTC:") {
mask = mask.slice(4);
utc = true;
}
var _ = utc ? "getUTC" : "get",
d = date[_ + "Date"](),
D = date[_ + "Day"](),
m = date[_ + "Month"](),
y = date[_ + "FullYear"](),
H = date[_ + "Hours"](),
M = date[_ + "Minutes"](),
s = date[_ + "Seconds"](),
L = date[_ + "Milliseconds"](),
o = utc ? 0 : date.getTimezoneOffset(),
flags = {
d: d,
dd: pad(d),
ddd: i18n.dayNames[D],
dddd: i18n.dayNames[D + 7],
m: m + 1,
mm: pad(m + 1),
mmm: i18n.monthNames[m],
mmmm: i18n.monthNames[m + 12],
yy: String(y).slice(2),
yyyy: y,
h: H % 12 || 12,
hh: pad(H % 12 || 12),
H: H,
HH: pad(H),
M: M,
MM: pad(M),
s: s,
ss: pad(s),
l: pad(L, 3),
L: pad(L > 99 ? Math.round(L / 10) : L),
t: H < 12 ? "a" : "p",
tt: H < 12 ? "am" : "pm",
T: H < 12 ? "A" : "P",
TT: H < 12 ? "AM" : "PM",
Z: utc ? "UTC" : (String(date).match(timezone) || [""]).pop().replace(timezoneClip, ""),
o: (o > 0 ? "-" : "+") + pad(Math.floor(Math.abs(o) / 60) * 100 + Math.abs(o) % 60, 4),
S: ["th", "st", "nd", "rd"][d % 10 > 3 ? 0 : (d % 100 - d % 10 != 10) * d % 10]
};
return mask.replace(token, function ($0) {
return $0 in flags ? flags[$0] : $0.slice(1, $0.length - 1);
});
};
})();這份程式先在 mask 中約定 yyyy、mm、dd 等有意義的符號代表日期元素,再逐一取出各元素,最後以 mask.replace(正則, 元素) 完成替換,並以 flags 對照表比對。
每次輸入冗長的 mask 字串未免麻煩,可透過常數預先定義:
dateFormat.masks = {
"default": "ddd mmm dd yyyy HH:MM:ss",
shortDate: "m/d/yy",
mediumDate: "mmm d, yyyy",
longDate: "mmmm d, yyyy",
fullDate: "dddd, mmmm d, yyyy",
shortTime: "h:MM TT",
mediumTime: "h:MM:ss TT",
longTime: "h:MM:ss TT Z",
isoDate: "yyyy-mm-dd",
isoTime: "HH:MM:ss",
isoDateTime: "yyyy-mm-dd'T'HH:MM:ss",
isoUtcDateTime: "UTC:yyyy-mm-dd'T'HH:MM:ss'Z'",
ChineseDate : 'yyyy年mm月dd日 HH時MM分'
};
dateFormat.i18n = {
dayNames: [
"Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat",
"Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"
],
monthNames: [
"Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec",
"January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"
]
};相較之下,月影前輩的寫法不到 20 行,卻將正則運用得淋漓盡致:
Date.prototype.format = function(format) //author: meizz
{
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;
}
alert(new Date().format("yyyy-MM-dd hh:mm:ss"));其中 ("00" + o[k]).substr(("" + o[k]).length) 是巧妙之處:透過在前面補上「00」再截取,即可取得最後兩位,實現補零效果。此外 test() 不僅用於檢測,還會產生 RegExp.$1 結果組供後續處理。
若覺得原版不易閱讀,也可改寫為語意清晰的版本,原理一致但少了技巧性:
date = {
format: function(date, format){
date = new Date(date);
date = {
year : date.getFullYear()
,month : date.getMonth() + 1
,day : date.getDate()
,hour : date.getHours()
,minute : date.getMinutes()
,second : date.getSeconds()
,milute : date.getMilliseconds()
};
var match ,reg = /(y+)|(Y+)|(M+)|d+|h+|m+|s+|u+/g;
while((match = reg.exec(format)) != null){
match = match[0];
if(/y/i.test(match)){ format = format.replace(match, date.year); }
if(match.indexOf('M') != -1){ format = format.replace(match, date.month); }
if(match.indexOf('d') != -1){ format = format.replace(match, date.day); }
if(match.indexOf('h') != -1){ format = format.replace(match, date.hour); }
if(match.indexOf('m') != -1){ format = format.replace(match, date.minute); }
if(match.indexOf('s') != -1){ format = format.replace(match, date.second); }
if(match.indexOf('u') != -1){ format = format.replace(match, date.milute); }
}
return format;
}
};掌握正則與 replace 的搭配後,日期格式化便能收放自如,也能延伸出各式中英文格式輸出。