Date 物件是 JavaScript 裡最容易被低估的內建型別。本文把日常開發最常用到的日期操作整理成一份可直接複製的工具庫,從基礎取值到格式化、日期差值、閏年判斷一次講完。
var myDate = new Date(); myDate.getYear(); // 兩位數年份(有 Y2K 問題,不建議使用) myDate.getFullYear(); // 完整四位年份 myDate.getMonth(); // 月份,注意是 0~11,0 代表一月 myDate.getDate(); // 日(1~31) myDate.getDay(); // 星期幾(0~6,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~11,以及 getDay() 用 0 代表星期日,這兩個偏移量搞錯就會出現「差一個月」或「星期算錯」的經典 bug。
下面這組方法把常用能力掛到原型上,讓日期物件可以直接串起來呼叫:
// ————————————————
// 判斷閏年
// ————————————————
Date.prototype.isLeapYear = function () {
var y = this.getFullYear();
return (y % 4 == 0 && (y % 100 != 0 || y % 400 == 0));
};
// ————————————————
// 日期格式化
// yyyy/YYYY 年、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(/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;
};
// ————————————————
// 日期計算(s 秒 / n 分 / h 時 / d 日 / w 週 / q 季 / m 月 / y 年)
// ————————————————
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;
};
// ————————————————
// 取得日期各部分的資訊
// y 年 / m 月 / d 日 / w 星期 / ww 第幾週 / h 時 / n 分 / s 秒
// ————————————————
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, partStr = '';
var Week = ['日', '一', '二', '三', '四', '五', '六'];
switch (interval) {
case 'y': partStr = d.getFullYear(); break;
case 'm': partStr = d.getMonth() + 1; break;
case 'd': partStr = d.getDate(); break;
case 'w': partStr = Week[d.getDay()]; break;
case 'h': partStr = d.getHours(); break;
case 'n': partStr = d.getMinutes(); break;
case 's': partStr = d.getSeconds(); break;
}
return partStr;
};
// ————————————————
// 取得當月最大天數
// ————————————————
Date.prototype.MaxDayOfDate = function () {
// 直接問 Date:下個月的最後一天,就是 0 號
var d = this;
return new Date(d.getFullYear(), d.getMonth() + 1, 0).getDate();
};
// ————————————————
// 字串轉日期(支援 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;
}
// ————————————————
// 兩個日期相差的天數
// ————————————————
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);
}
表單送進來的日期字串永遠不能信任,最好先驗一次:
// 格式為 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; // 月份要減 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 之後,再把各欄位讀回來跟原始輸入比對。像 2 月 30 日這種「日期物件會自動進位成 3 月 2 日」的情況,一比對就會被揪出來。
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; // 例如 2009-06-12 12:00
}
如果不想自己拼字串,也可以用本文的 Format 方法一行解決:new Date().Format('yyyy-MM-dd hh:mm')。另外,若要顯示毫秒或做高精度的時間差,記得一律用 getTime() 取得毫秒數再相減,避免用「一天 86400000 毫秒」硬算跨月、跨年的區間——那樣會被閏年與夏令時間坑到。
希望這份整理對你學習 JavaScript 程式設計有所幫助。