後端回傳的時間格式通常是 yyyy-MM-dd hh:mm:ss,但 Safari 與舊版 IE 對這種格式的 Date 建構子支援度不一,需要處理一下才能正常使用。
/**
* 將格式為 yyyy-MM-dd hh:mm:ss.S 的字串轉為 Date
* @param {String} dateString 時間字串
* @return {Date}
*/
function convertToDate(dateString) {
return new Date(dateString.replace(/-/g, "/"));
}
/**
* 比較兩個時間的先後
* @param {Date} date1
* @param {Date} date2
* @return {Number} date1 較早回傳負數,相同回傳 0,較晚回傳正數
*/
function compareDate(date1, date2) {
return date1.getTime() - date2.getTime();
}
new Date("2024-01-15 10:30:00") 這種以「-」分隔日期、「空白」分隔時間的格式,並不是 ECMAScript 標準定義的格式。標準只規定了 ISO 8601(2024-01-15T10:30:00,注意中間是 T)。因此各瀏覽器對非標準格式的解析結果不一致,Safari 就直接回傳 Invalid Date。
把 - 全換成 / 之後,2024/01/15 10:30:00 是各瀏覽器普遍共識可解析的格式,實用但終究是繞路。
Date 物件內部存的就是「從 1970-01-01T00:00:00Z 起的毫秒數」,getTime() 把它取出來。相減後:
date1 在 date2 之前date1 在 date2 之後這個「回傳正負零」的設計正好符合 Array.prototype.sort 的比較函式約定,可以直接傳進去用:
var list = [d3, d1, d2];
list.sort(compareDate);
其實 Date 物件被強制轉型為數字時就會自動呼叫 valueOf()(等同 getTime()),所以直接相減也可以:
date1 - date2; // 效果相同
date1 > date2; // 比較也正確
寫成 getTime() 的好處是意圖明確,讀程式碼的人一眼就知道你在比時間。
範例沒有做輸入驗證,傳入 null 或格式錯誤的字串會得到 Invalid Date,後續計算全部變成 NaN。加上防護會安全得多:
function convertToDate(dateString) {
if (!dateString) return null;
// 先嘗試標準 ISO 格式,失敗再退回 / 分隔格式
var d = new Date(dateString);
if (isNaN(d.getTime())) {
d = new Date(dateString.replace(/-/g, '/'));
}
return isNaN(d.getTime()) ? null : d;
}
function compareDate(date1, date2) {
var t1 = date1 instanceof Date ? date1.getTime() : convertToDate(date1)?.getTime();
var t2 = date2 instanceof Date ? date2.getTime() : convertToDate(date2)?.getTime();
if (t1 == null || t2 == null) return 0;
return t1 - t2;
}
日期處理的邊緣情況多得驚人(時區、閏秒、夏令時間、各國曆法),若專案裡日期邏輯不少,強烈建議用 Day.js(2KB,API 直觀)或 date-fns(可 tree-shaking、函式式),而 Moment.js 已進入維護模式不建議新專案採用。格式化時也別忘了 Intl.DateTimeFormat 這個原生 API:
new Intl.DateTimeFormat('zh-TW', {
year: 'numeric', month: '2-digit', day: '2-digit',
hour: '2-digit', minute: '2-digit', second: '2-digit', hour12: false
}).format(new Date());