js常规日期格式处理、月历渲染、倒计时函数

日期格式处理在前端的日常任务中非常常见，但是为此引入monent.js这样的类库又会显得有点臃肿，毕竟我们一个特定的项目中，并不需要monent.js那么全的涵盖范围。另外，如果现在公司让你自己手写一个日历组件（月历、周历），日历组件中需要耦合我们的其他业务需求，如果有一个任务列表，当11月22号的待进行任务，我需要在日历上有一个绿色圆点，表示当天有待办事项。下面介绍一些常规的函数，希望对大家有用。

• 月历效果图

函数目录

• getFormatDateStr 获得指定日期格式的字符串；
• getDayPrevAfter 获得n天前/后的日期；
• formatDateWithTimeZone 格式化日期带时区，ISO 8601；
• countDownBySecond 倒计时；
• monthSize 获得指定日期所在月的天数；
• getCalendarMonth 获得指定日期所在月的第一周到第四/五周的数据组合；
• getOneDateWeekIndex 获得指定的某天所在该月的第几周，下标从0开始；

下面是详细的说明：

• getFormatDateStr

  /**
   * [zeroPadding 小于10的数字补0，必填]
   * @param  {[Int]} value [description]
   * @return {[String]}       [description]
   */
  export function zeroPadding(value){
    return value < 10 ? `0${value}` : value;
  }
  
  /**
   * [_isDateStrSeparatorCh 判断日期格式字符串的分隔符是否是中文]
   * @param  {[String]} str [必填]
   * @return {[String]}     [分隔符]
   */
  function _getDateStrSeparator(str, startIndex, endIndex) {
    startIndex = startIndex ? startIndex : 4;
    endIndex = endIndex ? endIndex : 5;
    let separator = str.slice(startIndex, endIndex);
    if (separator === '年' || separator === '月' ) {
      separator = 'Ch';
    }
    return separator;
  }
  
  /**
   * [_isDateStrSeparatorCh 判断日期格式字符串的分隔符是否是中文]
   * @param  {[String]} str [必填]
   * @return {[String]}     [分隔符]
   */
  function _isDateStrSeparatorCh(str) {
    if ( str.indexOf('年')!=-1 || str.indexOf('月')!=-1 ) {
      return true;
    }
    return false;
  }
  
  /**
   * [getFormatDateStr 获得指定日期格式的字符串]
   * @param  {[String or Date]}  date  [要转换的日期，必填]
   * @param  {[String]}  dateFormatStr     [要转化的目标格式，必填，2016-11-22之间的分隔符可任意，可选项：
   * 'yyyy-mm-dd hh:mm:ss','yyyy/mm/dd hh:mm:ss','yyyy.mm.dd hh:mm:ss','yyyy年mm月dd hh:mm:ss',
   * 'yyyy-mm-dd hh:mm',
   * 'mm-dd hh:mm',
   * 'yyyy-mm-dd',
   * 'mm-dd',
   * 'hh:mm:ss',
   * 'hh:mm'
   * ]
   * @return {[String]}                [时间格式字符串]
   */
  export function getFormatDateStr(date, dateFormatStr) {
  
      if ( !(date instanceof Date) ) {
        if ( date.indexOf('-') != -1 ) {
          date.replace(/\-/g,'/');
        }
            date = new Date(date);
        }
  
      dateFormatStr = dateFormatStr.toLowerCase();
      if (!dateFormatStr){
        return false;
      }
  
      let returnStr = '',
          separator = _getDateStrSeparator(dateFormatStr),
          year = date.getFullYear(),
              month = date.getMonth() + 1,
              day = date.getDate(),
              hour = date.getHours(),
              minute = date.getMinutes(),
          second = date.getSeconds();
  
      if ( /^yyyy(.{1})mm(.{1})dd hh:mm:ss$/.test(dateFormatStr) ) {
        if (_isDateStrSeparatorCh(dateFormatStr)) {
          returnStr = `${year}年${zeroPadding(month)}月${zeroPadding(day)}日`;
        } else {
          separator =
          returnStr = `${year}${separator}${zeroPadding(month)}${separator}${zeroPadding(day)}`;
        }
        returnStr += ` ${zeroPadding(hour)}:${zeroPadding(minute)}:${zeroPadding(second)}`;
      } else if ( /^yyyy(.{1})mm(.{1})dd hh:mm$/.test(dateFormatStr) ) {
        if (_isDateStrSeparatorCh(dateFormatStr)) {
          returnStr = `${year}年${zeroPadding(month)}月${zeroPadding(day)}日`;
        } else {
          returnStr = `${year}${separator}${zeroPadding(month)}${separator}${zeroPadding(day)}`;
        }
        returnStr += ` ${zeroPadding(hour)}:${zeroPadding(minute)}`;
      } else if ( /^mm(.{1})dd hh:mm$/.test(dateFormatStr) ) {
        if (_isDateStrSeparatorCh(dateFormatStr)) {
          returnStr = `${zeroPadding(month)}月${zeroPadding(day)}日`;
        } else {
          separator = _getDateStrSeparator(dateFormatStr, 2, 3);
          returnStr = `${zeroPadding(month)}${separator}${zeroPadding(day)}`;
        }
        returnStr += ` ${zeroPadding(hour)}:${zeroPadding(minute)}`;
      } else if ( /^yyyy(.{1})mm(.{1})dd$/.test(dateFormatStr) ) {
        if (_isDateStrSeparatorCh(dateFormatStr)) {
          returnStr = `${year}年${zeroPadding(month)}月${zeroPadding(day)}日`;
        } else {
          returnStr = `${year}${separator}${zeroPadding(month)}${separator}${zeroPadding(day)}`;
        }
      } else if ( /^mm(.{1})dd$/.test(dateFormatStr) ) {
        if (_isDateStrSeparatorCh(dateFormatStr)) {
          returnStr = `${zeroPadding(month)}月${zeroPadding(day)}日`;
        } else {
          separator = _getDateStrSeparator(dateFormatStr, 2, 3);
          returnStr = `${zeroPadding(month)}${separator}${zeroPadding(day)}`;
        }
      } else if ( /^hh:mm:ss$/.test(dateFormatStr) ) {
        returnStr = `${zeroPadding(hour)}:${zeroPadding(minute)}:${zeroPadding(second)}`;
      } else if ( /^hh:mm$/.test(dateFormatStr) ) {
        returnStr = `${zeroPadding(hour)}:${zeroPadding(minute)}`;
      }
  
    return returnStr;
  
  }

  
  

• getDayPrevAfter

  /**
   * [getDayPrevAfter 获得n天前/后的日期]
   * @param  {[String]} date    [日期，非必填参数，表示调用时的时间]
   * @param  {[String]} type    [前一天还是后一天，非必填参数，默认后一天]
   * @param  {[Int]} daysNum [天数，非必填参数，默认一天]
   * @return {[Date]}         [description]
   */
  export function getDayPrevAfter(date, type, daysNum) {
  
    date = date ? date : new Date();
    type = type ? type : 'after';
    daysNum = daysNum ? daysNum : 1;
  
    if ( !(date instanceof Date) ) {
      if ( date.indexOf('-') != -1 ) {
        date.replace(/\-/g,'/');
      }
      date = new Date(date);
    }
  
    let returnDate = date;
    if (type === 'prev') {
      returnDate = new Date(date.getTime() - (daysNum * 24 * 60 * 60 * 1000));
    } else if (type === 'after') {
      returnDate = new Date(date.getTime() + (daysNum * 24 * 60 * 60 * 1000));
    }
    return returnDate;
  
  }

  
  

• formatDateWithTimeZon

• /**
   * [formatDateWithTimeZone 格式化日期带时区，ISO 8601]
   * @param  {[Date]} date [日期，非必填参数，表示调用时的时间]
   * @return {[String]}     [ISO 8601格式的日期，example: 2016-11-21T14:09:15+08:00]
   */
  export function formatDateWithTimeZone(date) {
  
    date = date ? date : new Date();
    if ( !(date instanceof Date) ) {
      if ( date.indexOf('-') != -1 ) {
        date.replace(/\-/g,'/');
      }
      date = new Date(date);
    }
  
    let tzo = -date.getTimezoneOffset(),
        dif = tzo >= 0 ? '+' : '-',
        pad = function (num) {
            let norm = Math.abs(Math.floor(num));
            return zeroPadding(norm);
        };
      return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}T${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}${dif}${pad(tzo / 60)}:${pad(tzo % 60)}`;
  
  }

  
  
  

• countDownBySecond

  /**
   * [countDownBySecond 倒计时]
   * @param  {[Int]} restSeconds   [剩余秒数，必填]
   * @param  {[Int]} timeInterval   [时间间隔，非必填，默认1000ms]
   * @param  {[Function]} func   [每倒计时一次，就需要执行一次的回调函数名，非必填]
   * @param  {[Function]} endFun [倒计时结束需要执行的函数名，非必填]
   * @return {[null]}        [无返回值]
   */
  export function countDownBySecond(restSeconds, timeInterval, func, endCallback) {
      let timer = null;
      let total = restSeconds;
      timeInterval = timeInterval ? timeInterval : 1000;
      timer = setInterval(function() {
          --total;
          if (total <= 0) {
              clearInterval(timer);
              endCallback && endCallback();
          }
          func && func(total);
      }, timeInterval);
  }

  
  

• monthSize

  /**
   * [monthSize 获得指定日期所在月的天数]
   * @param  {[Date]} oDate [指定的日期，非必填，默认为当天]
   * @return {[Int]}       [总天数]
   */
  function monthSize(oDate) {
      oDate = oDate ? oDate : new Date();
      let year = oDate.getFullYear(),
          month = oDate.getMonth(),
          _oDate = new Date();
      _oDate.setFullYear(year);
      _oDate.setMonth(month + 1, 0);
      return _oDate.getDate();
  }

  
  

• getCalendarMonth

  /**
   * [getCalendarMonth 获得指定日期所在月的第一周到第四/五周的数据组合，形如：
   * [{
      "date": "2016/10/30", //日期字符串
      "dateNum": 30,  //日
      "isCurMonth": false, //是否当前月
      "weekIndex": 0 //是本月的第几周，下标从0开始
    },{
      "date": "2016/10/31",
      "dateNum": 31,
      "isCurMonth": false,
      "weekIndex": 0
    },{
      "date": "2016/11/1",
      "dateNum": 1,
      "day": 2,
      "isCurMonth": true,
      "isToday": false,
      "weekIndex": 0
    }]
    ]
   * @param  {[Date]} param [指定的日期，非必填，默认为当天]
   * @return {[Array]}       [获得指定日期所在月的第一周到第四/五周的数据组合]
   */
  export function getCalendarMonth(date) {
      date = date ? date : new Date();
      let y = date.getFullYear();
      let m = date.getMonth();
      let _m;
      let firstDay = new Date(y, m, 1).getDay(); //当月第一天 周期
      let days = monthSize(date);//当月天数
      let prevMonthDays = monthSize(new Date(y, m - 1));//上月天数
      let initPrevDay = prevMonthDays - firstDay;
      let lines = Math.ceil((firstDay + days) / 7);
      _m = new Array(lines * 7);
      let nextMonthDay = 0;
  
      for (let i = 0; i < _m.length; i++) {
          let weekIndex = parseInt(i / 7);
          if (i < firstDay) {
              let date = ++initPrevDay;
              if (m === 0 && date > 7) {
                  _m[i] = {
                      isCurMonth: false,
                      dateNum: date,
                      weekIndex,
                      date: `${y - 1}/${12}/${date}`
                  };
              } else {
                  _m[i] = {
                      isCurMonth: false,
                      dateNum: date,
                      weekIndex,
                      date: `${y}/${m}/${date}`
                  };
              }
          } else if (i >= (firstDay + days)) {
              let date = ++nextMonthDay;
  
              if (m === 11 && date <= 7) {
                  _m[i] = {
                      isCurMonth: false,
                      dateNum: date,
                      weekIndex,
                      date: `${y + 1}/${1}/${date}`
                  };
              } else {
                  _m[i] = {
                      isCurMonth: false,
                      dateNum: date,
                      weekIndex,
                      date: `${y}/${m + 2}/${date}`
                  };
              }
          } else {
              let _date = i - firstDay + 1;
              let today = new Date();
              let today_y = today.getFullYear();
              let today_m = today.getMonth();
              let today_d = today.getDate();
              let isToday = today_y === y && today_m === m && today_d === _date ? true : false;
              _m[i] = {
                  dateNum: _date, //日期
                  day: i % 7, //周期
                  weekIndex,
                  isCurMonth: true,
                  isToday,
                  date: `${y}/${m + 1}/${_date}`
              };
          }
      }
      return _m;
  }

  
  

• getOneDateWeekIndex

  /**
   * [getOneDateWeekIndex 获得指定的某天所在该月的第几周，下标从0开始]
   * @param  {[Date]} date [指定的日期，非必填，默认为当天]
   * @return {[Int]}      [在该月的第几周]
   */
  export function getOneDateWeekIndex(date) {
      date = date ? date : new Date();
      let monthDays = getCalendarMonth(date);
      let dateString = getFormatDateStr(date, '/', true, false, false);
      let returnDate = monthDays.filter(item => {
          return item.date === dateString;
      });
      let weekIndex = returnDate[0].weekIndex;
      return weekIndex ? weekIndex : 0;
  }

  
  

用上面的函数就能够实现日期格式转换，倒计时，自定义月历等常规的需要，希望对大家有用~