DIV CSS 佈局教程網

JavaScript 日期格式化:自 timeStamp 到 yyyy-MM-dd HH:mm 的實作
編輯:JavaScript綜合知識     

後端常回傳毫秒級時間戳記,前端需要把它轉成人類可讀的格式。以下實作提供兩個工具函式。

從毫秒數格式化為日期字串

/**
 * 將毫秒數轉為格式化日期
 * @param {Number} ms 自 1970-01-01 00:00:00 UTC 起的毫秒數
 * @returns {String} 格式為 yyyy-MM-dd HH:mm
 */
Util.parseToDate = function (ms) {
    var date = new Date(parseInt(ms, 10));
    return Util.formatDate(date, "yyyy-MM-dd HH:mm");
};

核心格式化函式

/**
 * 格式化日期
 * yyyy = 年,MM = 月,dd = 日,HH = 時(24),mm = 分
 * 範例:Util.formatDate(new Date(), 'yyyy-MM-dd HH:mm')
 *       Util.formatDate(new Date(), 'yyyy/MM/dd HH:mm')
 * @param {Date} date 要格式化的日期物件
 * @param {String} style 格式樣式字串
 * @returns {String} 格式化後的字串
 */
Util.formatDate = function (date, style) {
    var y = date.getFullYear();

    var M = "0" + (date.getMonth() + 1);
    M = M.substring(M.length - 2);

    var d = "0" + date.getDate();
    d = d.substring(d.length - 2);

    var h = "0" + date.getHours();
    h = h.substring(h.length - 2);

    var m = "0" + date.getMinutes();
    m = m.substring(m.length - 2);

    return style.replace('yyyy', y)
                .replace('MM', M)
                .replace('dd', d)
                .replace('hh', h)
                .replace('mm', m);
};

這裡有兩個值得留意的細節:

補零技巧:先在前端補一個 "0",再取後兩個字元,就能把 3 變成 "03"、12 維持 "12"。這比寫三元判斷簡潔。

為什麼用 hh 而不是 HH:原始實作用小寫 hh 代表 24 小時制,這與多數日期函式庫的慣例(HH 為 24 小時、hh 為 12 小時)相反。沿用時要特別注意,否則容易混淆。

更穩健的重寫版本

原版連續呼叫五次 replace 有個潛在問題:替換是有順序的。若樣式中同時出現 MM 與 M,先替換 MM 之後再處理單獨的 M 就可能誤換。改用單次全域正則搭配對照表更安全:

Util.formatDate = function (date, style) {
    var pad = function (n) { return n < 10 ? '0' + n : '' + n; };
    var map = {
        yyyy: date.getFullYear(),
        MM:   pad(date.getMonth() + 1),
        dd:   pad(date.getDate()),
        HH:   pad(date.getHours()),
        mm:   pad(date.getMinutes()),
        ss:   pad(date.getSeconds())
    };
    return style.replace(/yyyy|MM|dd|HH|mm|ss/g, function (key) {
        return map[key];
    });
};

用一次全域 replace 同時處理所有占位符,既避免連鎖誤換,也更容易擴充(要加秒、毫秒、星期只要往 map 裡補一項)。

現代替代方案

ES2020 之後,如果目標環境允許,直接用 Intl.DateTimeFormat 會更簡潔,也自動處理多語系:

new Intl.DateTimeFormat('zh-TW', {
    year: 'numeric', month: '2-digit', day: '2-digit',
    hour: '2-digit', minute: '2-digit', hour12: false
}).format(new Date());
// "2026-08-14 23:09"

需要自訂格式字串時,toLocaleString 或成熟函式庫(Day.js、date-fns)也是不錯的選擇。

幾個時區陷阱

  • new Date(1234567890) 的參數是毫秒;若後端給的是秒,必須先乘 1000。
  • getFullYear()、getMonth() 等取的是本地時區;若需要 UTC,請用 getUTCFullYear() 系列。
  • getMonth() 從 0 開始,所以必須 +1,這是最常見的離村子弟。
  • 只給日期字串(如 "2026-08-14")給 new Date() 會被當成 UTC 解析,在某些時區可能顯示為前一天,處理時要留意。

日期處理看似簡單,卻是 bug 密度最高的地區之一。能標準化的地方就用標準 API,不能的時候也要把時區與進位假設寫清楚。

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