日期處理是 JavaScript 裡最容易出錯的領域之一:月份從 0 開始、時區預設跟著系統跑、getYear() 回傳的是「年份減 1900」。這份整理從基礎取用到實用工具函式,把常用操作一次列齊。
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():需要標準格式時直接使用,不必自己補零。最後提醒一個實務上最常出問題的點:後端傳來的時間字串若不含時區資訊,JavaScript 的解析結果會依瀏覽器而異。跨時區的系統請一律以 UTC 傳輸、以 ISO 8601 格式(含 Z 或時區偏移)表示,只在顯示的最後一刻轉換為使用者當地的時間。這一條守則能省下你無數個深夜的除錯時間。