日期處理是每個專案都會碰到的髒活。原生 Date 提供了基礎的讀取方法,但格式化、閏年判斷、日期相減這些常用操作都得自己刻。本文把內建 API 與一份實用的擴充函式整理在一起,可直接放進你的工具檔。
var mydate = new Date(); mydate.getYear(); // 年份後兩位(例如 126,即 1900 起算) mydate.getFullYear(); // 完整年份(四位數) mydate.getMonth(); // 月份,0 代表一月(0-11) mydate.getDate(); // 日(1-31) mydate.getDay(); // 星期(0-6,0 為週日) mydate.getTime(); // 自 1970.1.1 起的毫秒數 mydate.getHours(); // 小時(0-23) mydate.getMinutes(); // 分(0-59) mydate.getSeconds(); // 秒(0-59) mydate.getMilliseconds(); // 毫秒(0-999) mydate.toLocaleDateString(); // 目前日期 mydate.toLocaleTimeString(); // 目前時間 mydate.toLocaleString(); // 日期與時間
最容易踩的兩個坑:月份從 0 開始,以及 getYear() 回傳的是「1900 起算」的偏移值——現代程式請一律改用 getFullYear()。
透過 Date.prototype 擴充後,你可以獲得:isLeapYear(判斷閏年)、Format(格式化)、DateAdd(日期加減)、DateDiff(相減求差)、toString(轉字串)、toArray(拆分為陣列)、DatePart(取單一成分)、MaxDayOfDate(當月天數)、WeekNumOfYear(年度第幾週),以及全域的 StringToDate、IsValidDate、CheckDateTime、daysBetween。
Date.prototype.isLeapYear = function () {
var y = this.getFullYear();
return (0 == y % 4 && (0 != y % 100 || 0 == y % 400));
};
支援 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.getFullYear() % 100) > 9
? (this.getFullYear() % 100).toString()
: '0' + (this.getFullYear() % 100));
str = str.replace(/MM/, this.getMonth() + 1 > 9
? (this.getMonth() + 1).toString()
: '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().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;
};
這裡我修正了原始寫法的月份位移:內建的 getMonth() 回傳 0-11,格式化輸出時必須 +1,否則一月會被印成 00。另外 replace 是逐次呼叫的,因此「先長後短」的順序很重要——若先換掉單字母 M,後面的 MM 就永遠不會命中。
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());
}
};
參數 strInterval 分別代表秒、分、時、日、週、季、月、年。月以上的單位直接用 Date 建構子處理,能自動沿日期溢出(例如 1 月 31 日加一個月會得到 3 月 2 或 3 日),這也是為什麼月、年不能單純用毫秒相加。
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);
}
原始寫法在取「日」時用了 substring(len, lastIndexOf('-')+1),起點大於終點會回傳空字串,導致計算失敗;這裡已改為從最後一個 - 之後取到結尾。
Date.prototype.toString = function (showWeek) {
var myDate = this;
var str = myDate.toLocaleDateString();
if (showWeek) {
var Week = ['日', '一', '二', '三', '四', '五', '六'];
str += ' 星期' + Week[myDate.getDay()];
}
return str;
};
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 'h': return d.getHours();
case 'n': return d.getMinutes();
case 's': return d.getSeconds();
}
};
Date.prototype.MaxDayOfDate = function () {
// 下個月 1 日減一天,就是本月最後一天
var d = this;
return new Date(d.getFullYear(), d.getMonth() + 1, 0).getDate();
};
取得「當月最大天數」不必繞一大圈,new Date(year, month + 1, 0) 就是一個乾淨的技巧:日期 0 會被正規化成上一天。關於「年度第幾週」,原稿用了 document.write 輸出 VBScript 的寫法,那在現代瀏覽器完全不會執行,實務上請改用 ISO 8601 的計算方式:
Date.prototype.WeekNumOfYear = function () {
var d = new Date(Date.UTC(this.getFullYear(), this.getMonth(), this.getDate()));
var dayNum = d.getUTCDay() || 7;
d.setUTCDate(d.getUTCDate() + 4 - dayNum); // 移到該週的星期四
var yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
return Math.ceil((((d - yearStart) / 86400000) + 1) / 7);
};
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;
}
function IsValidDate(DateStr) {
var sDate = DateStr.replace(/(^\s+|\s+$)/g, ''); // 去前後空白
if (sDate == '') { return true; }
// 若符合 YYYY-MM-DD / 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(/[-\/]/);
// 逐欄比對,可攔下 2 月 30 日這類「格式正確但日期不存在」的輸入
if (ar[0] != t.getFullYear() || ar[1] != t.getMonth() + 1 || ar[2] != t.getDate()) {
return false;
}
} else {
return false;
}
return true;
}
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]);
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];
}
IsValidDate 的核心價值在「回頭比對」:JS 會把 2 月 30 日自動正規化成 3 月 2 日,只有把年月日拆出來跟原字串逐欄對照,才能真正判斷使用者輸入的日期存不存在——閏年 2 月 29 日也因此在同一套邏輯裡被正確處理。
擴充 Date.prototype 雖然方便,但在多人協作或引入第三方函式庫時,容易與其他人的擴充或未來的標準方法衝突。新專案我會建議改用 dayjs 或 date-fns 這類不可變(immutable)的函式庫,把格式化、加減、比較都寫成純函式,除錯與測試都更輕鬆。若只是維護老系統,上面這份工具箱依然堪用,只要記住我已修正的三處:月份 +1、daysBetween 取日的起點、以及年度週數改用 UTC 計算。