DIV CSS 佈局教程網

JavaScript 日期與時間操作大全
編輯:JavaScript綜合知識     

日期處理是 JavaScript 裡最容易出錯的領域之一:月份從 0 開始、時區預設跟著系統跑、getYear() 回傳的是「年份減 1900」。這份整理從基礎取用到實用工具函式,把常用操作一次列齊。

基礎:Date 物件的取用方法

var myDate = new Date();

myDate.getYear();            // 年份後兩位(1900 基準,不建議使用)
myDate.getFullYear();        // 完整年份,例如 2026
myDate.getMonth();           // 月份 0-11,注意 0 代表一月
myDate.getDate();            // 日 1-31
myDate.getDay();             // 星期 0-6,0 是週日
myDate.getHours();           // 小時 0-23
myDate.getMinutes();         // 分 0-59
myDate.getSeconds();         // 秒 0-59
myDate.getMilliseconds();    // 毫秒 0-999
myDate.getTime();            // 自 1970-01-01 起的毫秒數

myDate.toLocaleDateString(); // 目前日期
myDate.toLocaleTimeString(); // 目前時間
myDate.toLocaleString();     // 日期 + 時間

兩個最容易忘記的細節:getMonth() 要加一才是人類讀的月份;getYear() 已不建議使用,請一律改用 getFullYear()。

判斷閏年

Date.prototype.isLeapYear = function() {
  var y = this.getFullYear();
  return (0 == y % 4 && (y % 100 != 0 || y % 400 == 0));
};

日期格式化

支援 yyyy/yy 年、MM/M 月、dd/d 日、hh/H 時、mm/m 分、ss/s 秒與 w/W 星期:

Date.prototype.Format = function(formatStr) {
  var str = formatStr;
  var Week = ['日', '一', '二', '三', '四', '五', '六'];

  str = str.replace(/yyyy|YYYY/, this.getFullYear());
  str = str.replace(/MM/, this.getMonth() + 1 > 9 ? (this.getMonth() + 1) : '0' + (this.getMonth() + 1));
  str = str.replace(/M/g, this.getMonth() + 1);
  str = str.replace(/w|W/g, Week[this.getDay()]);
  str = str.replace(/dd|DD/, this.getDate() > 9 ? this.getDate() : '0' + this.getDate());
  str = str.replace(/d|D/g, this.getDate());
  str = str.replace(/hh|HH/, this.getHours() > 9 ? this.getHours() : '0' + this.getHours());
  str = str.replace(/h|H/g, this.getHours());
  str = str.replace(/mm/, this.getMinutes() > 9 ? this.getMinutes() : '0' + this.getMinutes());
  str = str.replace(/m/g, this.getMinutes());
  str = str.replace(/ss|SS/, this.getSeconds() > 9 ? this.getSeconds() : '0' + this.getSeconds());
  str = str.replace(/s|S/g, this.getSeconds());

  return str;
};

使用:new Date().Format("yyyy-MM-dd hh:mm:ss")。要提醒的是,這種「逐段 replace」的做法在遇到 yyyy-MM-dd 這類同時含大小寫的格式時容易互相干擾(例如 M 的替換會影響已處理過的部分)。正式專案建議改用 Intl.DateTimeFormat 或 toISOString() 加工。

日期運算

依指定單位做加減,回傳一個新的 Date:

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());
    case 'm': return new Date(dtTmp.getFullYear(), dtTmp.getMonth() + Number, dtTmp.getDate());
    case 'y': return new Date(dtTmp.getFullYear() + Number, dtTmp.getMonth(), dtTmp.getDate());
  }
};

注意 d(日)與 m(月)的做法不同:前者用毫秒相加,後者直接改寫建構子參數。為什麼?因為「加一天」永遠是 86400000 毫秒,但「加一個月」的長度不固定,必須交由 Date 建構子自行處理跨月與閏年的進位。

比較兩個日期的差值

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();
  }
};

兩個日期相差幾天

輸入格式為 YYYY-MM-dd 的字串:

function daysBetween(DateOne, DateTwo) {
  var OneMonth = DateOne.substring(5, DateOne.lastIndexOf('-'));
  var OneDay   = DateOne.substring(DateOne.lastIndexOf('-') + 1);
  var OneYear  = DateOne.substring(0, DateOne.indexOf('-'));

  var TwoMonth = DateTwo.substring(5, DateTwo.lastIndexOf('-'));
  var TwoDay   = DateTwo.substring(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);
}

更簡潔的現代寫法:Math.abs(new Date('2026-08-26') - new Date('2026-01-01')) / 86400000。要注意的是,若兩個日期分屬不同 DST 時區,用毫秒相除可能會差出幾小時,導致天數少算一天;嚴肳的日期差計算建議改用 UTC 或專門的日期函式庫。

日期合法性驗證

格式為 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}[-/]\d{1,2}[-/]\d{1,2}/g, '');
  if (s != '') return false;

  var t = new Date(sDate.replace(/-/g, '/'));
  var ar = sDate.split(/[-/:]/);

  if (ar[0] != t.getFullYear()
      || ar[1] != t.getMonth() + 1
      || ar[2] != t.getDate()) {
    return false;   // 例如 2026-02-30,Date 會自動進位成 3 月 2 日
  }
  return true;
}

這個「比對回去」的技巧很值得學:new Date('2026-02-30') 不會報錯,它會靜靜地變成 3 月 2 日。把解析結果的年、月、日再跟原始輸入比對一次,就能抓出這種被自動修正的非法日期。

完整日期時間檢查

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;   // 月份轉為 0 起算
  var d = new Date(r[1], r[2], r[3], r[4], r[5], r[6]);

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

轉陣列與取單一成分

Date.prototype.toArray = function() {
  var d = this;
  return [d.getFullYear(), d.getMonth(), d.getDate(),
          d.getHours(), d.getMinutes(), d.getSeconds()];
};

Date.prototype.DatePart = function(interval) {
  var d = this;
  var Week = ['日', '一', '二', '三', '四', '五', '六'];

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

取得當月最大天數

技巧是「下個月的第一天,減一天」:

Date.prototype.MaxDayOfDate = function() {
  var d = this;
  return new Date(d.getFullYear(), d.getMonth() + 1, 0).getDate();
};

new Date(year, month, 0) 中的「第 0 天」會被解讀為上個月的最後一天,這個小技巧比任何條件判斷都乾淨。

字串轉日期

支援 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-26 21:45 這樣的結果,手動補零即可:

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;
}

給現代專案的建議

上面這些工具函式在沒有函式庫的年代非常有用,理解它們也能幫助你搞懂 JavaScript 日期物件的種種古怪行為。但今天寫新專案時,請優先考慮:

  • Intl.DateTimeFormat:瀏覽器內建,格式化與本地化首選,自動處理各語言的慣用寫法。
  • Date.prototype.toISOString():需要標準格式時直接使用,不必自己補零。
  • Temporal API:新的標準日期方案,把「日期」與「時間」拆成不同型別,從根本上避開時區與閏秒的坑,值得關注其瀏覽器支援進度。
  • day.js / date-fns:需要大量運算時的輕量選擇,API 設計清晰且可 tree-shaking。

最後提醒一個實務上最常出問題的點:後端傳來的時間字串若不含時區資訊,JavaScript 的解析結果會依瀏覽器而異。跨時區的系統請一律以 UTC 傳輸、以 ISO 8601 格式(含 Z 或時區偏移)表示,只在顯示的最後一刻轉換為使用者當地的時間。這一條守則能省下你無數個深夜的除錯時間。

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