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

sf6255 7年前
   <p>日期格式处理在前端的日常任务中非常常见,但是为此引入monent.js这样的类库又会显得有点臃肿,毕竟我们一个特定的项目中,并不需要monent.js那么全的涵盖范围。另外,如果现在公司让你自己手写一个日历组件(月历、周历),日历组件中需要耦合我们的其他业务需求,如果有一个任务列表,当11月22号的待进行任务,我需要在日历上有一个绿色圆点,表示当天有待办事项。下面介绍一些常规的函数,希望对大家有用。</p>    <ul>     <li> <p>月历效果图</p> </li>    </ul>    <p style="text-align:center"><img src="https://simg.open-open.com/show/6934e0ac7facfe7f675d1c7d21b378bb.png"></p>    <p>函数目录</p>    <ul>     <li>getFormatDateStr 获得指定日期格式的字符串;</li>     <li>getDayPrevAfter 获得n天前/后的日期;</li>     <li>formatDateWithTimeZone 格式化日期带时区,ISO 8601;</li>     <li>countDownBySecond 倒计时;</li>     <li>monthSize 获得指定日期所在月的天数;</li>     <li>getCalendarMonth 获得指定日期所在月的第一周到第四/五周的数据组合;</li>     <li>getOneDateWeekIndex 获得指定的某天所在该月的第几周,下标从0开始;</li>    </ul>    <p>下面是详细的说明:</p>    <ul>     <li> <p>getFormatDateStr</p> </li>    </ul>    <pre>  <code class="language-javascript">/**   * [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;    }</code></pre>    <ul>     <li> <p>getDayPrevAfter</p> </li>    </ul>    <pre>  <code class="language-javascript">/**   * [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;    }</code></pre>    <ul>     <li> <p>formatDateWithTimeZone</p> </li>    </ul>    <pre>  <code class="language-javascript">/**   * [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)}`;    }</code></pre>    <ul>     <li> <p>countDownBySecond</p> </li>    </ul>    <pre>  <code class="language-javascript">/**   * [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);  }</code></pre>    <ul>     <li> <p>monthSize</p> </li>    </ul>    <pre>  <code class="language-javascript">/**   * [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();  }</code></pre>    <ul>     <li> <p>getCalendarMonth</p> </li>    </ul>    <pre>  <code class="language-javascript">/**   * [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;  }</code></pre>    <ul>     <li> <p>getOneDateWeekIndex</p> </li>    </ul>    <pre>  <code class="language-javascript">/**   * [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;  }</code></pre>    <p>用上面的函数就能够实现日期格式转换,倒计时,自定义月历等常规的需要,希望对您有用~</p>    <p> </p>    <p>来自:http://www.cnblogs.com/libin-1/p/6090696.html</p>    <p> </p>