微信小程序实现日期时间筛选器

开发微信小程序过程中，有个需求需要用到日期时间筛选器，查看微信官方文档后，发现官方文档的picker筛选器只能单独支持日期或者是时间，所以为了实现需求自己参考企业微信封装了个日期时间筛选器组件。

原理

筛选器的实现，我参考的是小程序官方方式，通过半屏弹窗（mp-half-screen-dialog）结合picker_view进行日期、时间的选择，最终在选择时间后，通过事件触发返回一个change事件，其中参数值为毫秒级时间戳。

实现

1.弹窗的显隐：

在组件的 properties 中传入一个 show 字段，用于控制弹窗的显隐；默认值为 false。

2.筛选器类型：

为了更好的兼容性，提供一个 type 字段，用于控制筛选器的所支持 可选择日期 的走向（往前、往后、前后都支持）；默认值为 center（前后都支持）。

3.时间区间（年）：

year 字段用于控制筛选器的年维度时间区间范围；默认值为 1。

4.时间区间（月）：

month 字段用于控制筛选器的月维度时间区间范围。默认值为 ‘undefined’****（声明’month’ 不为undefined时 year失效）。

具体思路：整体思路是监听弹窗的显隐（show），当弹窗显示时，获取对应配置项（类型、年、月）计算对应筛选器的范围，并初始化默认日期时间为当前年月日时分。

以下是效果图以及具体代码实现：

wxml代码

<mp-half-screen-dialog show="{{ show }}" maskClosable="{{ true }}" closabled="{{ false }}" extClass="f-date-dialog" catchtouchmove="preventTouchMove" bindclose="bindclose">
  <view slot="desc" class="flex column full-width full-height">
    <view class="bd flex full-width">
      <!-- 日期 -->
      <view class="flex1 flex column align-items-center">
        <picker-view indicator-style="height: 50px;" mode="selector" value="{{ [dateIndex] }}" class="selector__picker" bindchange="dateChange">
          <picker-view-column>
            <view wx:for="{{ dateArr }}" wx:key="index" style="line-height: 50px" class="text-center {{ item.name.length < 10 ? 'h4' : 'h6' }}">{{ item.name }}</view>
          </picker-view-column>
        </picker-view>
      </view>
      <!-- 小时 -->
      <view class="flex1 flex column align-items-center">
        <picker-view indicator-style="height: 50px;" mode="selector" value="{{ [hourValue] }}" class="selector__picker" bindchange="hourChange">
          <picker-view-column>
            <view wx:for="{{ hourArr }}" wx:key="index" style="line-height: 50px" class="text-center">{{ item }}</view>
          </picker-view-column>
        </picker-view>
      </view>
      <!-- 分钟 -->
      <view class="flex1 flex column align-items-center">
        <picker-view indicator-style="height: 50px;" mode="selector" value="{{ [minValue] }}" class="selector__picker" bindchange="minChange">
          <picker-view-column>
            <view wx:for="{{ minArr }}" wx:key="index" style="line-height: 50px" class="text-center">{{ item }}</view>
          </picker-view-column>
        </picker-view>
      </view>
    </view>

    <view class="ft flex align-items-center justify-content-space-between">
      <button type="default" style="width:45%;height: 40px;" class="weui-btn" bindtap="bindclose">取消</button>
      <button type="primary" style="width:45%;height: 40px;margin-top:0" class="weui-btn" bindtap="handleSubmit">确定</button>
    </view>
  </view>
</mp-half-screen-dialog>

js代码

const utils = require('../../utils/util')

Component({
  options: {
    addGlobalClass: true
  },

  properties: {
    show: {
      type: Boolean,
      value: false,
      observer: '_showChange'
    },
    type: {
      type: String,
      value: 'center' // 类型：'left' -- 现在往前   'center' -- 往前&往后   'right' -- 现在往后
    },
    year: {
      type: Number,
      value: 1 // '时间区间{year}年' month不为undefined时该项失效
    },
    month: {
      type: [Number, String],
      value: 'undefined' // 'month' 不为undefined时  year失效
    }
  },

  data: {
    dateIndex: null,
    hourValue: '',
    minValue: '',
    dateArr: [],
    hourArr: [],
    minArr: [],

    activeTime: null // 抛出的时间戳
  },

  methods: {
    _showChange(e) {
      if (e) {
        this.handleDateData()
        this.initData()
      }
    },

    handleSubmit() {
      this.bindclose()
      this.triggerEvent('change', { value: this.data.activeTime })
    },

    initData() {
      const now = +new Date()
      const index = this.data.dateArr.map(v => v.name).indexOf(utils.formatTime(now, '{m}月{d}日周{a}'))
      let tmp = this.data.dateArr
      tmp[index].name = '今天'

      this.setData({
        dateIndex: index,
        hourValue: utils.formatTime(now, '{h}'),
        minValue: utils.formatTime(now, '{i}'),
        dateArr: tmp,
        activeTime: now
      })
    },

    handleDateData() {
      const nowYear = new Date().getFullYear()
      let mins = []
      let hours = []
      let dates = []

      // 获取小时、分钟数组
      for (let i = 0; i < 60; i++) {
        mins.push(i.toString().length < 2 ? '0' + i : i.toString())
      }
      for (let j = 0; j < 24; j++) {
        hours.push(j.toString().length < 2 ? '0' + j : j.toString())
      }

      dates = this.getDays(nowYear)

      this.setData({
        hourArr: hours,
        minArr: mins,
        dateArr: dates
      })
    },

    getDays(year) {
      let pre_days = []
      let now_days = []
      let aft_days = []

      if (this.data.month == 'undefined') {
        /** 按年处理 */
        // 判断类型
        if (this.data.type == 'left') {
          for (let a = this.data.year; a >= 1; a--) {
            pre_days.push(...this.getDaysByYear(year - a, true))
          }
        } else if (this.data.type == 'right') {
          for (let b = 1; b <= this.data.year; b++) {
            aft_days.push(...this.getDaysByYear(year + b, true))
          }
        } else {
          for (let a = this.data.year; a >= 1; a--) {
            pre_days.push(...this.getDaysByYear(year - a, true))
          }
          for (let b = 1; b <= this.data.year; b++) {
            aft_days.push(...this.getDaysByYear(year + b, true))
          }
        }
        now_days = this.getDaysByYear(year)
      } else {
        /** 按月处理 */
        now_days = this.getDaysByMonth(year, this.data.type)
      }

      return pre_days.concat(now_days.concat(aft_days))
    },

    getDaysByYear(year, isIncludeYear) {
      let days = []
      for (let k = 1; k < 13; k++) {
        let each_days = new Date(year, k, 0).getDate()
        for (let _k = 1; _k <= each_days; _k++) {
          let time = +new Date(`${year}-${k}-${_k}`)
          if (isIncludeYear) {
            days.push({ name: utils.formatTime(time, '{y}年{m}月{d}日周{a}'), value: time })
          } else {
            days.push({ name: utils.formatTime(time, '{m}月{d}日周{a}'), value: time })
          }
        }
      }
      return days
    },

    getDaysByMonth(year, type) {
      let days = []
      let nowMonth = new Date().getMonth() + 1

      // 当月份传负的或0时当成本月
      if (this.data.month > 0) {
        let months = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
        let pre_mons = []
        let aft_mons = []

        // 生成往前、往后的月份数组
        for (let k = 1; k <= this.data.month; k++) {
          let tmp_pre = months.indexOf(nowMonth) - k
          let tmp_aft = months.indexOf(nowMonth) + k
          pre_mons.unshift(months[tmp_pre < 0 ? 12 + tmp_pre : tmp_pre])
          aft_mons.push(months[tmp_aft > 12 ? tmp_aft - 12 : tmp_aft])
        }
        if (type != 'right') {
          // 往前的月份的日期
          pre_mons.forEach(v => {
            // 跨年
            let month_days = 0
            if (v > nowMonth) {
              month_days = new Date(year - 1, v, 0).getDate()
              for (let k = 1; k <= month_days; k++) {
                let time = +new Date(`${year - 1}-${v}-${k}`)
                days.push({ name: utils.formatTime(time, '{y}年{m}月{d}日周{a}'), value: time })
              }
            } else {
              month_days = new Date(year, v, 0).getDate()
              for (let k = 1; k <= month_days; k++) {
                let time = +new Date(`${year}-${v}-${k}`)
                days.push({ name: utils.formatTime(time, '{m}月{d}日周{a}'), value: time })
              }
            }
          })
        }

        // 本月的日期
        let month_days = new Date(year, nowMonth, 0).getDate()
        for (let k = 1; k <= month_days; k++) {
          let time = +new Date(`${year}-${nowMonth}-${k}`)
          days.push({ name: utils.formatTime(time, '{m}月{d}日周{a}'), value: time })
        }

        if (type != 'left') {
          // 往后的月份的日期
          aft_mons.forEach(_v => {
            // 跨年
            let month_days = 0
            if (_v < nowMonth) {
              month_days = new Date(year + 1, _v, 0).getDate()
              for (let k = 1; k <= month_days; k++) {
                let time = +new Date(`${year + 1}-${_v}-${k}`)
                days.push({ name: utils.formatTime(time, '{y}年{m}月{d}日周{a}'), value: time })
              }
            } else {
              month_days = new Date(year, _v, 0).getDate()
              for (let k = 1; k <= month_days; k++) {
                let time = +new Date(`${year}-${_v}-${k}`)
                days.push({ name: utils.formatTime(time, '{m}月{d}日周{a}'), value: time })
              }
            }
          })
        }
      } else {
        let month_days = new Date(year, nowMonth, 0).getDate()
        for (let k = 1; k <= month_days; k++) {
          let time = +new Date(`${year}-${nowMonth}-${k}`)
          days.push({ name: utils.formatTime(time, '{m}月{d}日周{a}'), value: time })
        }
      }

      return days
    },

    dateChange(e) {
      const day = this.data.dateArr[e.detail.value[0]]
      let time = day.value + (Number(this.data.hourValue) * 3600 + Number(this.data.minValue) * 60) * 1000
      this.setData({
        dateIndex: e.detail.value[0],
        activeTime: time
      })
    },

    hourChange(e) {
      const hour = Number(this.data.hourArr[e.detail.value[0]])
      let time = this.data.dateArr[this.data.dateIndex].value + (hour * 3600 + Number(this.data.minValue) * 60) * 1000
      this.setData({
        hourValue: this.data.hourArr[e.detail.value[0]],
        activeTime: time
      })
    },

    minChange(e) {
      const min = Number(this.data.minArr[e.detail.value[0]])
      let time = this.data.dateArr[this.data.dateIndex].value + (Number(this.data.hourValue) * 3600 + min * 60) * 1000
      this.setData({
        minValue: this.data.minArr[e.detail.value[0]],
        activeTime: time
      })
    },

    bindclose() {
      this.setData({
        show: false
      })
    },

    preventTouchMove() {
      // 阻止半屏状态下 页面滑动
    }
  }
})

wxss代码

.selector__picker {
  width: 100%;
  height: 80%;
  margin-top: 20px;
  font-size: 24px;
}

上述代码中，js中引用的 utils 功能函数如下：

/**
 * 日期格式化
 */
export function formatTime(time, cFormat) {
  if (arguments.length === 0) {
    return ''
  }
  const format = cFormat || '{y}-{m}-{d}'
  let date
  if (time === undefined || time === 0 || time === '') {
    return ''
  } else if (typeof time === 'object') {
    date = time
  } else {
    if (('' + time).length === 10) time = parseInt(time) * 1000
    date = new Date(time)
  }
  const formatObj = {
    y: date.getFullYear(),
    m: date.getMonth() + 1,
    d: date.getDate(),
    h: date.getHours(),
    i: date.getMinutes(),
    s: date.getSeconds(),
    a: date.getDay()
  }
  const time_str = format.replace(/{(y|m|d|h|i|s|a)+}/g, (result, key) => {
    let value = formatObj[key]
    // Note: getDay() returns 0 on Sunday
    if (key === 'a') {
      return ['日', '一', '二', '三', '四', '五', '六'][value]
    }
    if (result.length > 0 && value < 10) {
      value = '0' + value
    }
    return value || 0
  })
  return time_str
}

另外wxml中使用的一些wxss公共样式就不提供了。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持我们。