日期處理看起來簡單,實際寫起來卻最容易出錯——月份要加一、跨月進位、時區偏移、字串解析相容性,每一項都是坑。以下整理七個高頻需求的函式寫法,可以直接複製進工具函式庫。
function getNowTime() {
return new Date();
}
關鍵是先把時間轉成毫秒數(getTime()),加上天數換算後的毫秒量,再還原成 Date 物件。一天固定是 24 × 60 × 60 × 1000 毫秒。
function getTimeAddDays(time, days) {
return new Date(time.getTime() + days * 24 * 60 * 60 * 1000);
}
務必記得 getMonth() 回傳的是 0 到 11,所以要加一。另外實務上通常會補零成 2026-08-26 這種固定寬度格式,若要對齊 this 需求可再包一層 padStart。
function getFormatDate(time) {
var m = time.getMonth() + 1;
var d = time.getDate();
m = m < 10 ? '0' + m : m;
d = d < 10 ? '0' + d : d;
return time.getFullYear() + "-" + m + "-" + d;
}
直接 new Date("2011-11-20") 在部分舊版 IE 與 Safari 上會得到 Invalid Date。把「-」換成「/」是流傳很廣的相容性寫法,能避開這類解析差異。
function convertToDate(strings) {
return new Date(Date.parse(strings.replace(/-/g, "/")));
}
注意這裡用 /-/g 全域替換,只寫一個 - 會漏掉後面兩個分隔符。
var WEEKDAYS = ["周日", "周一", "周二", "周三", "周四", "周五", "周六"];
function getFormatWeek(time) {
return WEEKDAYS[time.getDay()];
}
getDay() 回傳 0(週日)到 6(週六),剛好可以當陣列索引使用。
function compareTime(time1, time2) {
return time1.getTime() - time2.getTime();
}
回傳值大於 0 代表 time1 在後,小於 0 代表 time1 在後面,等於 0 則相同。這個形式正好符合 Array.prototype.sort 的 comparator 慣例,可以直接傳進去排序。
function getDays(time1, time2) {
var day = 24 * 60 * 60 * 1000;
return (time1.getTime() - time2.getTime()) / day;
}
如果只在意「日曆上的天數差」而不是精確的 24 小時倍數,建議先把兩個時間的時、分、秒都歸零再相減,否則遇到日光節約時間或跨 DST 的情境會算出小數。
這些函式適合用於中小型專案的常見場景,但日期時間本質上是個複雜主題。若你的專案涉及多時區、跨國使用者、行事曆計算或 i18n 格式化,與其自行拼湊,不如直接採用 Day.js、date-fns 或 Temporal API——自己維護時區資料庫的更新成本遠高於引入一個成熟套件。
希望這七個小函式能幫你省下一些重複查找的時間。