DIV CSS 佈局教程網

JavaScript 日期格式化七種寫法整理與挑選建議
編輯:關於JavaScript     

日期格式化大概是 JavaScript 裡最容易被重複造輪子的需求之一。本文把七種常見做法集中整理,從經典的正則替換、到直接呼叫原生方法,最後再補一個「幾分鐘前」這類相對時間的寫法。

方法一:meizz 的經典 Format

流傳最廣的版本。用一個對照表 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/24 小時制的 pattern

在方法一的基礎上多了 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

方法三:單一正則一次比對的 mask 寫法

不逐一跑迴圈,而是用一個大正則把所有占位符一次掃出,命中後丟進 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 格式的字串。

方法五、六:字串連續 replace 版

不用迴圈,直接把 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 造成全域污染。

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