後端常回傳毫秒級時間戳記,前端需要把它轉成人類可讀的格式。以下實作提供兩個工具函式。
/**
* 將毫秒數轉為格式化日期
* @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,不能的時候也要把時區與進位假設寫清楚。