DIV CSS 佈局教程網

js 時間日期格式化封裝函數詳解
編輯:關於JavaScript     

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 也能獲得本地化的格式化能力,不必自己維護模板解析邏輯。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved