日期格式化大概是 JavaScript 裡最容易被重複造輪子的需求之一。本文把七種常見做法集中整理,從經典的正則替換、到直接呼叫原生方法,最後再補一個「幾分鐘前」這類相對時間的寫法。
流傳最廣的版本。用一個對照表 o 存放各時間單位,再用正則逐一替換;捕獲到的字串長度為 1 時直接放值,長度大於 1 則用 ("00" + 值).substr(...) 補零。
// 對 Date 的擴充,將 Date 轉化為指定格式的 String
// 月(M)、日(d)、小時(h)、分(m)、秒(s)、季度(q) 可用 1-2 個占位符
// 年(y) 可用 1-4 個占位符,毫秒(S) 只能用 1 個占位符(1-3 位數字)
// (new Date()).Format("yyyy-MM-dd hh:mm:ss.S") ==> 2006-07-02 08:09:04.423
Date.prototype.Format = function (fmt) {
var o = {
"M+": this.getMonth() + 1, // 月份
"d+": this.getDate(), // 日
"h+": this.getHours(), // 小時
"m+": this.getMinutes(), // 分
"s+": this.getSeconds(), // 秒
"q+": Math.floor((this.getMonth() + 3) / 3), // 季度
"S": this.getMilliseconds() // 毫秒
};
if (/(y+)/.test(fmt)) {
fmt = fmt.replace(RegExp.$1, (this.getFullYear() + "").substr(4 - RegExp.$1.length));
}
for (var k in o) {
if (new RegExp("(" + k + ")").test(fmt)) {
fmt = fmt.replace(RegExp.$1, (RegExp.$1.length == 1) ?
(o[k]) : (("00" + o[k]).substr(("" + o[k]).length)));
}
}
return fmt;
};
// 呼叫方式
var time1 = new Date().Format("yyyy-MM-dd");
var time2 = new Date().Format("yyyy-MM-dd HH:mm:ss");
在方法一的基礎上多了 12 小時制 h、24 小時制 H,以及星期表示 E(可透過占位符數量輸出「二」「周二」「星期二」)。
Date.prototype.pattern = function (fmt) {
var o = {
"M+": this.getMonth() + 1,
"d+": this.getDate(),
"h+": this.getHours() % 12 == 0 ? 12 : this.getHours() % 12,
"H+": this.getHours(),
"m+": this.getMinutes(),
"s+": this.getSeconds(),
"q+": Math.floor((this.getMonth() + 3) / 3),
"S": this.getMilliseconds()
};
var week = {
"0": "日", "1": "一", "2": "二", "3": "三",
"4": "四", "5": "五", "6": "六"
};
if (/(y+)/.test(fmt)) {
fmt = fmt.replace(RegExp.$1, (this.getFullYear() + "").substr(4 - RegExp.$1.length));
}
if (/(E+)/.test(fmt)) {
fmt = fmt.replace(RegExp.$1, ((RegExp.$1.length > 1) ?
(RegExp.$1.length > 2 ? "星期" : "周") : "") + week[this.getDay() + ""]);
}
for (var k in o) {
if (new RegExp("(" + k + ")").test(fmt)) {
fmt = fmt.replace(RegExp.$1, (RegExp.$1.length == 1) ?
o[k] : (("00" + o[k]).substr(("" + o[k]).length)));
}
}
return fmt;
};
var date = new Date();
window.alert(date.pattern("yyyy-MM-dd EEE hh:mm:ss")); // 2009-03-10 星期二 08:09:04
不逐一跑迴圈,而是用一個大正則把所有占位符一次掃出,命中後丟進 switch 決定回傳值。這種結構擴充新單位最直覺,也最容易讀。
Date.prototype.format = function (mask) {
var d = this;
var zeroize = function (value, length) {
if (!length) length = 2;
value = String(value);
for (var i = 0, zeros = ''; i < (length - value.length); i++) { zeros += '0'; }
return zeros + value;
};
return mask.replace(/"[^"]*"|'[^']*'|\b(?:d{1,4}|m{1,4}|yy(?:yy)?|([hHMstT])\1?|[lLZ])\b/g,
function ($0) {
switch ($0) {
case 'd': return d.getDate();
case 'dd': return zeroize(d.getDate());
case 'ddd': return ['Sun','Mon','Tue','Wed','Thr','Fri','Sat'][d.getDay()];
case 'dddd':return ['Sunday','Monday','Tuesday','Wednesday',
'Thursday','Friday','Saturday'][d.getDay()];
case 'M': return d.getMonth() + 1;
case 'MM': return zeroize(d.getMonth() + 1);
case 'MMM': return ['Jan','Feb','Mar','Apr','May','Jun',
'Jul','Aug','Sep','Oct','Nov','Dec'][d.getMonth()];
case 'yy': return String(d.getFullYear()).substr(2);
case 'yyyy':return d.getFullYear();
case 'h': return d.getHours() % 12 || 12;
case 'hh': return zeroize(d.getHours() % 12 || 12);
case 'H': return d.getHours();
case 'HH': return zeroize(d.getHours());
case 'm': return d.getMinutes();
case 'mm': return zeroize(d.getMinutes());
case 's': return d.getSeconds();
case 'ss': return zeroize(d.getSeconds());
case 'l': return zeroize(d.getMilliseconds(), 3);
case 'tt': return d.getHours() < 12 ? 'am' : 'pm';
case 'TT': return d.getHours() < 12 ? 'AM' : 'PM';
case 'Z': return d.toUTCString().match(/[A-Z]+$/);
default: return $0.substr(1, $0.length - 2); // 取出被引號包住的字面字串
}
});
};
其實不寫任何擴充也有東西可用,只是輸出格式各異:
var date = new Date();
document.writeln(date); // Thu Jan 08 2015 01:25:53 GMT+0800(中國標準時間)
document.writeln(Date.parse('6/10/2014')); // 1402329600000 毫秒數
document.writeln(Date.parse('Thu Jan 08 2015 01:25:53')); // 1420651553000 毫秒數
document.writeln(date.toDateString()); // Thu Jan 08 2015
document.writeln(date.toTimeString()); // 01:39:08 GMT+0800
document.writeln(date.toLocaleDateString());// 2015年1月8日
document.writeln(date.toLocaleTimeString());// 上午1:39:08
document.writeln(date.toUTCString()); // Wed, 07 Jan 2015 17:39:08 GMT
注意 Date.parse() 不傳參數會得到 NaN,字串格式各瀏覽器支援度也不一致,正式環境建議只餵 ISO 8601 格式的字串。
不用迴圈,直接把 yyyy、MM、dd 等一條條 replace 過去。程式碼直白、沒有迴圈,缺點是同一個 Date 物件若重複呼叫 Format 容易互相污染,且 /M/g 這類無錨點的規則有可能誤傷格式字串中的其他字母。
Date.prototype.Format = function (formatStr) {
var str = formatStr;
var Week = ['日', '一', '二', '三', '四', '五', '六'];
str = str.replace(/yyyy|YYYY/, this.getFullYear());
str = str.replace(/yy|YY/, (this.getYear() % 100) > 9 ?
(this.getYear() % 100).toString() : '0' + (this.getYear() % 100));
str = str.replace(/MM/, (this.getMonth() + 1) > 9 ?
(this.getMonth() + 1).toString() : '0' + (this.getMonth() + 1));
str = str.replace(/M/g, (this.getMonth() + 1));
str = str.replace(/w|W/g, Week[this.getDay()]);
str = str.replace(/dd|DD/, this.getDate() > 9 ?
this.getDate().toString() : '0' + this.getDate());
str = str.replace(/d|D/g, this.getDate());
str = str.replace(/hh|HH/, this.getHours() > 9 ?
this.getHours().toString() : '0' + this.getHours());
str = str.replace(/h|H/g, this.getHours());
str = str.replace(/mm/, this.getMinutes() > 9 ?
this.getMinutes().toString() : '0' + this.getMinutes());
str = str.replace(/m/g, this.getMinutes());
str = str.replace(/ss|SS/, this.getSeconds() > 9 ?
this.getSeconds().toString() : '0' + this.getSeconds());
str = str.replace(/s|S/g, this.getSeconds());
return str;
}
社群網站常用的「剛剛/XX 分鐘前/今天 XX:XX」這類顯示,判斷規則是分層的:跨年顯示完整日期,跨日顯示月日,當天顯示時分,一小時內顯示分鐘數。
/* 1、< 60s,顯示為「剛剛」
2、>= 1min && < 60min,顯示「XX分鐘前」
3、>= 60min && < 1day,顯示「今天 XX:XX」
4、>= 1day && < 1year,顯示「XX月XX日 XX:XX」
5、>= 1year,顯示「XXXX年XX月XX日 XX:XX」 */
function timeFormat(time) {
var date = new Date(time), curDate = new Date(),
year = date.getFullYear(), month = date.getMonth() + 1,
day = date.getDate(), hour = date.getHours(), minute = date.getMinutes(),
curYear = curDate.getFullYear(), curHour = curDate.getHours(), timeStr;
if (year < curYear) {
timeStr = year + '年' + month + '月' + day + '日 ' + hour + ':' + minute;
} else {
var pastTime = curDate - date, pastH = pastTime / 3600000;
if (pastH > curHour) {
timeStr = month + '月' + day + '日 ' + hour + ':' + minute;
} else if (pastH >= 1) {
timeStr = '今天 ' + hour + ':' + minute + '分';
} else {
var pastM = curDate.getMinutes() - minute;
timeStr = pastM > 1 ? pastM + '分鐘前' : '剛剛';
}
}
return timeStr;
}
七種寫法裡,方法七在產品上最實用,也最貼近使用者語感;若只需要單純格式化,方法一與方法三是最耐用的選擇。不過在今天的專案中,更推薦直接用 Intl.DateTimeFormat 或 dayjs、date-fns 這類函式庫,能省下大量邊界條件處理,也避免自己改寫 Date.prototype 造成全域污染。