DIV CSS 佈局教程網

JavaScript 日期字串轉 Date 與時間比較的兩個實用函式
編輯:JavaScript綜合知識     

後端回傳的時間格式通常是 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 是各瀏覽器普遍共識可解析的格式,實用但終究是繞路。

比較時間為什麼用 getTime()

Date 物件內部存的就是「從 1970-01-01T00:00:00Z 起的毫秒數」,getTime() 把它取出來。相減後:

  • 結果 < 0:date1 在 date2 之前
  • 結果 = 0:兩者相同
  • 結果 > 0: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());
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved