DIV CSS 佈局教程網

JS 日期與時間處理大集合:從基本取值到格式化與運算
編輯:關於JavaScript     

日期處理是每個前端專案都躲不掉的課題,也是最容易被低估複雜度的部分。這篇把常用的取值方法、格式化與運算工具一次整理起來。

基本取值

var myDate = new Date();

myDate.getYear();            // 兩位數年份(有 century 問題,不建議使用)
myDate.getFullYear();        // 完整四位數年份
myDate.getMonth();           // 月份,0 起算(0 代表一月)
myDate.getDate();            // 當日,1–31
myDate.getDay();             // 星期,0 起算(0 代表週日)
myDate.getTime();            // 自 1970-01-01 起的毫秒數
myDate.getHours();           // 小時,0–23
myDate.getMinutes();         // 分鐘,0–59
myDate.getSeconds();         // 秒數,0–59
myDate.getMilliseconds();    // 毫秒,0–999
myDate.toLocaleDateString(); // 當地日期字串
myDate.toLocaleTimeString(); // 當地時間字串
myDate.toLocaleString();     // 日期+時間

getMonth() 從 0 開始這件事,是無數 bug 的源頭。顯示月份時記得 +1。

擴充方法清單

  • Date.prototype.isLeapYear 判斷是否為閏年
  • Date.prototype.Format 日期格式化
  • Date.prototype.DateAdd 日期加減運算
  • Date.prototype.DateDiff 計算兩個日期的差值
  • Date.prototype.toString 轉為字串
  • Date.prototype.toArray 拆成陣列
  • Date.prototype.DatePart 取出日期的某一部分
  • Date.prototype.MaxDayOfDate 取得該月天數
  • Date.prototype.WeekNumOfYear 當年度第幾週
  • StringToDate 字串轉日期物件
  • IsValidDate 驗證日期有效性
  • CheckDateTime 完整日期時間檢查
  • daysBetween 相差天數

實作程式碼

// 判斷閏年
Date.prototype.isLeapYear = function () {
  return (0 == this.getYear() % 4 &&
          ((this.getYear() % 100 != 0) || (this.getYear() % 400 == 0)));
};

// 日期格式化
// YYYY/yyyy/YY/yy 年份 MM/M 月份 W/w 星期
// dd/DD/d/D 日期 hh/HH/h/H 時 mm/m 分 ss/SS/s/S 秒
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() > 9
        ? this.getMonth().toString() : '0' + this.getMonth());
  str = str.replace(/M/g, this.getMonth());
  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;
};

// 兩個日期相差的天數(格式 YYYY-MM-DD)
function daysBetween(DateOne, DateTwo) {
  var OneMonth = DateOne.substring(5, DateOne.lastIndexOf('-'));
  var OneDay = DateOne.substring(DateOne.length, DateOne.lastIndexOf('-') + 1);
  var OneYear = DateOne.substring(0, DateOne.indexOf('-'));
  var TwoMonth = DateTwo.substring(5, DateTwo.lastIndexOf('-'));
  var TwoDay = DateTwo.substring(DateTwo.length, DateTwo.lastIndexOf('-') + 1);
  var TwoYear = DateTwo.substring(0, DateTwo.indexOf('-'));

  var cha = (Date.parse(OneMonth + '/' + OneDay + '/' + OneYear) -
             Date.parse(TwoMonth + '/' + TwoDay + '/' + TwoYear)) / 86400000;
  return Math.abs(cha);
}

// 日期加減
Date.prototype.DateAdd = function (strInterval, Number) {
  var dtTmp = this;
  switch (strInterval) {
    case 's': return new Date(Date.parse(dtTmp) + (1000 * Number));
    case 'n': return new Date(Date.parse(dtTmp) + (60000 * Number));
    case 'h': return new Date(Date.parse(dtTmp) + (3600000 * Number));
    case 'd': return new Date(Date.parse(dtTmp) + (86400000 * Number));
    case 'w': return new Date(Date.parse(dtTmp) + ((86400000 * 7) * Number));
    case 'q': return new Date(dtTmp.getFullYear(),
                             (dtTmp.getMonth()) + Number * 3,
                             dtTmp.getDate(), dtTmp.getHours(),
                             dtTmp.getMinutes(), dtTmp.getSeconds());
    case 'm': return new Date(dtTmp.getFullYear(),
                             (dtTmp.getMonth()) + Number,
                             dtTmp.getDate(), dtTmp.getHours(),
                             dtTmp.getMinutes(), dtTmp.getSeconds());
    case 'y': return new Date((dtTmp.getFullYear() + Number),
                             dtTmp.getMonth(), dtTmp.getDate(),
                             dtTmp.getHours(), dtTmp.getMinutes(),
                             dtTmp.getSeconds());
  }
};

// 比較日期差
Date.prototype.DateDiff = function (strInterval, dtEnd) {
  var dtStart = this;
  if (typeof dtEnd == 'string') {
    dtEnd = StringToDate(dtEnd);
  }
  switch (strInterval) {
    case 's': return parseInt((dtEnd - dtStart) / 1000);
    case 'n': return parseInt((dtEnd - dtStart) / 60000);
    case 'h': return parseInt((dtEnd - dtStart) / 3600000);
    case 'd': return parseInt((dtEnd - dtStart) / 86400000);
    case 'w': return parseInt((dtEnd - dtStart) / (86400000 * 7));
    case 'm': return (dtEnd.getMonth() + 1) +
                     ((dtEnd.getFullYear() - dtStart.getFullYear()) * 12) -
                     (dtStart.getMonth() + 1);
    case 'y': return dtEnd.getFullYear() - dtStart.getFullYear();
  }
};

// 重載 toString,可選擇附上星期
Date.prototype.toString = function (showWeek) {
  var myDate = this;
  var str = myDate.toLocaleDateString();
  if (showWeek) {
    var Week = ['日', '一', '二', '三', '四', '五', '六'];
    str += ' 星期' + Week[myDate.getDay()];
  }
  return str;
};

// 日期合法性驗證,格式 YYYY-MM-DD 或 YYYY/MM/DD
function IsValidDate(DateStr) {
  var sDate = DateStr.replace(/(^\s+|\s+$)/g, '');   // 去兩端空白
  if (sDate == '') return true;

  // 符合 YYYY-M-D 等各種寫法時,正則會被替換成空字串
  var s = sDate.replace(/[\d]{4,4}[\-/]{1}[\d]{1,2}[\-/]{1}[\d]{1,2}/g, '');

  if (s == '') {
    var t = new Date(sDate.replace(/\-/g, '/'));
    var ar = sDate.split(/[-/:]/);
    if (ar[0] != t.getYear() ||
        ar[1] != t.getMonth() + 1 ||
        ar[2] != t.getDate()) {
      return false;      // 例:2 月 30 日這類不存在的日期
    }
  } else {
    return false;
  }
  return true;
}

// 日期時間檢查,格式 YYYY-MM-DD HH:MM:SS
function CheckDateTime(str) {
  var reg = /^(\d+)-(\d{1,2})-(\d{1,2}) (\d{1,2}):(\d{1,2}):(\d{1,2})$/;
  var r = str.match(reg);
  if (r == null) return false;

  r[2] = r[2] - 1;
  var d = new Date(r[1], r[2], r[3], r[4], r[5], r[6]);

  if (d.getFullYear() != r[1]) return false;
  if (d.getMonth() != r[2]) return false;
  if (d.getDate() != r[3]) return false;
  if (d.getHours() != r[4]) return false;
  if (d.getMinutes() != r[5]) return false;
  if (d.getSeconds() != r[6]) return false;
  return true;
}

// 拆成陣列
Date.prototype.toArray = function () {
  var myDate = this;
  var myArray = Array();
  myArray[0] = myDate.getFullYear();
  myArray[1] = myDate.getMonth();
  myArray[2] = myDate.getDate();
  myArray[3] = myDate.getHours();
  myArray[4] = myDate.getMinutes();
  myArray[5] = myDate.getSeconds();
  return myArray;
};

// 取得日期的某個部分
// y 年 m 月 d 日 w 星期 ww 第幾週 h 時 n 分 s 秒
Date.prototype.DatePart = function (interval) {
  var myDate = this;
  var partStr = '';
  var Week = ['日', '一', '二', '三', '四', '五', '六'];

  switch (interval) {
    case 'y':  partStr = myDate.getFullYear(); break;
    case 'm':  partStr = myDate.getMonth() + 1; break;
    case 'd':  partStr = myDate.getDate(); break;
    case 'w':  partStr = Week[myDate.getDay()]; break;
    case 'ww': partStr = myDate.WeekNumOfYear(); break;
    case 'h':  partStr = myDate.getHours(); break;
    case 'n':  partStr = myDate.getMinutes(); break;
    case 's':  partStr = myDate.getSeconds(); break;
  }
  return partStr;
};

// 字串轉日期,支援 MM/dd/YYYY、YYYY/MM/dd、YYYY-MM-dd 等
function StringToDate(DateStr) {
  var converted = Date.parse(DateStr);
  var myDate = new Date(converted);

  if (isNaN(myDate)) {
    var arys = DateStr.split('-');
    myDate = new Date(arys[0], --arys[1], arys[2]);
  }
  return myDate;
}

輸出「2026-08-31 18:30」這種格式

function CurentTime() {
  var now = new Date();
  var year = now.getFullYear();
  var month = now.getMonth() + 1;
  var day = now.getDate();
  var hh = now.getHours();
  var mm = now.getMinutes();

  var clock = year + "-";
  if (month < 10) clock += "0";
  clock += month + "-";
  if (day < 10) clock += "0";
  clock += day + " ";
  if (hh < 10) clock += "0";
  clock += hh + ":";
  if (mm < 10) clock += '0';
  clock += mm;

  return clock;
}

給今天的提醒

上面這套寫法有它的時代背景,其中幾點值得修正。首先 getYear() 應全面改用 getFullYear(),前者在部分環境會回傳「年份減 1900」,是經典的千禧蟲地雷。其次,直接擴充 Date.prototype 容易與其他函式庫衝突,改寫成獨立工具函式更安全。

最後,日期時間真正的難題從來不是格式化,而是時區與夏令時間。若你的專案會跨時區顯示,請認真考慮 Intl.DateTimeFormat 或 Temporal API,別自己攤火山。

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