日期與時間的處理永遠是開發中的痛點,格式繁雜、需求多變。本文分享一個以 jQuery 為基礎封裝的時間工具類 TimeObjectUtil,把常見的驗證、格式化與換算操作集中管理,隨取隨用。
這個工具類的設計理念是「驗證一律回傳 false 表示不合規」,並涵蓋了以下幾類實用方法:獲取當前毫秒數、毫秒與時間格式互轉、多種日期格式化(純日期、含 00:00:00、含完整時間),以及一堆時間區間的合理性驗證。
var TimeObjectUtil;
/**
* @title 時間工具類
* @note 本類一律違規驗證返回 false
* @formatter "2013-07-01 00:00:00" , "2013-07-01"
*/
TimeObjectUtil = {
// 獲取當前時間毫秒數
getCurrentMsTime : function() {
var myDate = new Date();
return myDate.getTime();
},
// 毫秒轉時間格式
longMsTimeConvertToDateTime : function(time) {
var myDate = new Date(time);
return this.formatterDateTime(myDate);
},
// 時間格式轉毫秒
dateToLongMsTime : function(date) {
var myDate = new Date(date);
return myDate.getTime();
},
// 格式化日期(不含時間)
formatterDate : function(date) {
var datetime = date.getFullYear()
+ "-"
+ ((date.getMonth() + 1) > 10 ? (date.getMonth() + 1) : "0" + (date.getMonth() + 1))
+ "-"
+ (date.getDate() < 10 ? "0" + date.getDate() : date.getDate());
return datetime;
},
// 格式化日期(含時間 "00:00:00")
formatterDate2 : function(date) {
var datetime = date.getFullYear()
+ "-"
+ ((date.getMonth() + 1) > 10 ? (date.getMonth() + 1) : "0" + (date.getMonth() + 1))
+ "-"
+ (date.getDate() < 10 ? "0" + date.getDate() : date.getDate())
+ " " + "00:00:00";
return datetime;
},
// 格式化日期(含完整時間)
formatterDateTime : function(date) {
var datetime = date.getFullYear()
+ "-"
+ ((date.getMonth() + 1) > 10 ? (date.getMonth() + 1) : "0" + (date.getMonth() + 1))
+ "-"
+ (date.getDate() < 10 ? "0" + date.getDate() : date.getDate())
+ " "
+ (date.getHours() < 10 ? "0" + date.getHours() : date.getHours())
+ ":"
+ (date.getMinutes() < 10 ? "0" + date.getMinutes() : date.getMinutes())
+ ":"
+ (date.getSeconds() < 10 ? "0" + date.getSeconds() : date.getSeconds());
return datetime;
},
// 時間比較:結束時間大於開始時間
compareDateEndTimeGTStartTime : function(startTime, endTime) {
return ((new Date(endTime.replace(/-/g, "/"))) > (new Date(startTime.replace(/-/g, "/"))));
},
// 驗證開始時間合理性:開始時間不能小於當前時間 X 個月
compareRightStartTime : function(month, startTime) {
var now = formatterDayAndTime(new Date());
var sms = new Date(startTime.replace(/-/g, "/"));
var ems = new Date(now.replace(/-/g, "/"));
var tDayms = month * 30 * 24 * 60 * 60 * 1000;
var dvalue = ems - sms;
if (dvalue > tDayms) { return false; }
return true;
},
// 驗證結束時間合理性:結束時間不能小於當前時間 X 個月
compareRightEndTime : function(month, endTime) {
var now = formatterDayAndTime(new Date());
var sms = new Date(now.replace(/-/g, "/"));
var ems = new Date(endTime.replace(/-/g, "/"));
var tDayms = month * 30 * 24 * 60 * 60 * 1000;
var dvalue = sms - ems;
if (dvalue > tDayms) { return false; }
return true;
},
// 驗證結束時間與開始時間的間隔不能大於 X 個月
compareEndTimeGTStartTime : function(month, startTime, endTime) {
var sms = new Date(startTime.replace(/-/g, "/"));
var ems = new Date(endTime.replace(/-/g, "/"));
var tDayms = month * 30 * 24 * 60 * 60 * 1000;
var dvalue = ems - sms;
if (dvalue > tDayms) { return false; }
return true;
},
// 獲取最近幾天(時間往前推算)
getRecentDaysDateTime : function(day) {
var daymsTime = day * 24 * 60 * 60 * 1000;
var yesterDatsmsTime = this.getCurrentMsTime() - daymsTime;
var startTime = this.longMsTimeConvertToDateTime(yesterDatsmsTime);
var pastDate = this.formatterDate2(new Date(startTime));
var nowDate = this.formatterDate2(new Date());
return { startTime : pastDate, endTime : nowDate };
},
// 獲取今天(開始與結束時間)
getTodayDateTime : function() {
var daymsTime = 24 * 60 * 60 * 1000;
var tomorrowDatsmsTime = this.getCurrentMsTime() + daymsTime;
var currentTime = this.longMsTimeConvertToDateTime(this.getCurrentMsTime());
var termorrowTime = this.longMsTimeConvertToDateTime(tomorrowDatsmsTime);
var nowDate = this.formatterDate2(new Date(currentTime));
var tomorrowDate = this.formatterDate2(new Date(termorrowTime));
return { startTime : nowDate, endTime : tomorrowDate };
},
// 獲取明天(開始與結束時間)
getTomorrowDateTime : function() {
var daymsTime = 24 * 60 * 60 * 1000;
var tomorrowDatsmsTime = this.getCurrentMsTime() + daymsTime;
var termorrowTime = this.longMsTimeConvertToDateTime(tomorrowDatsmsTime);
var theDayAfterTomorrowDatsmsTime = this.getCurrentMsTime() + (2 * daymsTime);
var theDayAfterTomorrowTime = this.longMsTimeConvertToDateTime(theDayAfterTomorrowDatsmsTime);
var pastDate = this.formatterDate2(new Date(termorrowTime));
var nowDate = this.formatterDate2(new Date(theDayAfterTomorrowTime));
return { startTime : pastDate, endTime : nowDate };
}
};
實務上要留意一點:程式裡以「一個月約 30 天」來估算月份間隔,這是為了簡化計算的近似做法,若你的場景對精度要求很高(例如嚴格對齊日曆月),就需要另行調整。此外範例中 compareRightStartTime、compareRightEndTime 用到的 formatterDayAndTime 需自行補上對應實作。整體而言,把這些常用邏輯集中封裝,能大幅提升日期處理的可讀性與重用性。