DIV CSS 佈局教程網

打造 jQuery 時間工具類:驗證、格式化與換算一次搞定
編輯:JavaScript綜合知識     

日期與時間的處理永遠是開發中的痛點,格式繁雜、需求多變。本文分享一個以 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 需自行補上對應實作。整體而言,把這些常用邏輯集中封裝,能大幅提升日期處理的可讀性與重用性。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved