JS 提供了大量獲取時間的 Date 方法——getDate、getDay、getFullYear、getHours 等等,卻沒有像 Java 的 SimpleDateFormat 那樣,讓你傳入一個模板字符串就直接得到格式化結果。下面這個封裝就是為了填補這一空缺。
arguments:代表當前函數的參數集合。不能顯式創建,雖然有 length 屬性、也能用 [] 取值,但它並不是真數組。
typeof:返回表示表達式數據類型的字符串,可能的取值為 number、string、boolean、object、function、undefined。
constructor:表示創建對象的函數,用於判斷對象是否由某個構造器產生。
exec:用正則模式在字符串中查找,返回包含匹配結果的數組,失敗則返回 null。
split:以正則或子字符串分割字符串並返回數組,這裡用來判斷某類格式符是否重複出現。
throw:拋出異常,後面可跟任意表達式。
模板字符串採用嚴謹格式:每類格式符只能連續出現一次,超出範圍會拋出異常。比如 yyyy-mm-yyyy 這種寫法就會報錯。
支持的格式符:y 表示年(2 位或 4 位)、q 表示季度(1 位)、M 表示月(1~2 位)、d 表示日(1~2 位)、H 表示 24 小時制小時、h 表示 12 小時制小時、m 表示分、s 表示秒、S 表示毫秒(固定 1 位)。
/**
* js 時間日期格式化
* 模版字符串採用嚴謹格式,超出則拋出異常,且每類格式只可出現一次
* @param {Date} date 日期對象
* @param {String} fmt 模板字符串
* @return 格式化後的時間日期字符串
*/
function DateFormat(date, fmt){
if (arguments.length != 2) // 參數個數校驗
throw Error('arguments長度不合法');
if (!date || (typeof date != 'object') || (date.constructor != Date)) // 參數合法性校驗
throw Error(arguments[0] + ':類型不為Date類型');
if (/H+/.test(fmt) && /h+/.test(fmt))
throw Error("小時格式錯誤,同類型只能連續出現一次!");
/* 模板參數校驗 */
var verify = function(Rex){
var arr = new RegExp(Rex).exec(fmt); // 獲得匹配結果數組
if (!arr) // 匹配失敗
return "";
if (fmt.split(Rex).length > 2) // 同一類型間隔出現多次
throw Error("fmt格式錯誤:同類型只能連續出現一次!");
return arr[0];
};
var o = { // 數據存儲對象
"y+": date.getFullYear() + "",
"q+": Math.floor((date.getMonth() + 3) / 3),
"M+": date.getMonth() + 1 + "",
"d+": date.getDate() + "",
"H+": date.getHours() + "",
"h+": date.getHours() + "",
"m+": date.getMinutes() + "",
"s+": date.getSeconds() + "",
"S+": date.getMilliseconds()
};
/**
* 月、日、時、分、秒的通用匹配替換
* @param r 數據對象的鍵
* @param rex 對應的正則
*/
var common = function(r, rex, len) {
if(len != 1 && len != 2)
throw Error("格式錯誤:只能出現1/2次");
len == 2
? fmt = fmt.replace(rex, o[r].length == 1 ? "0" + o[r] : o[r])
: fmt = fmt.replace(rex, o[r]);
};
for(var r in o) {
var rex, len, temp;
rex = new RegExp(r);
temp = verify(rex); // 匹配所得字符串
len = temp.length;
if(!len) continue;
if(r == "y+") {
if(len != 2 && len != 4)
throw Error("年份格式錯誤:y只能出現2/4次");
len == 2
? fmt = fmt.replace(rex, o[r].substr(2, 2))
: fmt = fmt.replace(rex, o[r]);
} else if(r == "q+") {
if(len != 1)
throw Error("季度格式錯誤:q只能出現1次");
fmt = fmt.replace(rex, o[r]);
} else if(r == "h+") {
if(len != 1 && len != 2)
throw Error("小時格式錯誤:h只能出現1/2次");
var h = (o[r] > 12 ? o[r] - 12 : o[r]) + "";
len == 2
? fmt = fmt.replace(rex, h.length == 1 ? "0" + h : h)
: fmt = fmt.replace(rex, h);
} else if(r == "S+") {
if(len != 1)
throw Error("毫秒數格式錯誤:S只能出現1次");
fmt = fmt.replace(rex, o[r]);
} else {
// M+ / d+ / H+ / m+ / s+
common(r, rex, len);
}
}
return fmt;
}
console.log(DateFormat(new Date(), 'yyyy年第q季度M月dd日HH時m分s秒S毫秒'));

把年份寫成 4 位或 2 位,輸出會相應變化:
console.log(DateFormat(new Date(), 'yyyy年yy第q季度M月dd日HH時m分s秒S毫秒'));

把 H 換成 h 即切換為 12 小時制:
console.log(DateFormat(new Date(), 'yyyy年第q季度M月dd日Hh時m分s秒S毫秒'));

若第一個參數不是 Date 對象,會拋出類型異常:
console.log(DateFormat("我不是時間對象", 'yyyy年第q季度M月dd日Hh時m分s秒S毫秒'));

同一類格式符重複出現時同樣會報錯:
console.log(DateFormat(new Date(), 'yyyy年第q季度MMM月dd日HH時m分s秒S毫秒'));

其餘組合就不逐一列舉了,有興趣的可以直接把代碼拷下來測試。若發現 bug 或有可優化之處,歡迎指正。
最後補充一點現代寫法:ES5 之後可以考慮直接調用 Date.prototype.toISOString(),或引入 moment.js、day.js 這類成熟庫;若只需簡單場景,用 Intl.DateTimeFormat 也能獲得本地化的格式化能力,不必自己維護模板解析邏輯。