vant-weapp/packages/datetime-picker

DatetimePicker 时间选择

时间选择组件通常与 弹出层 组件配合使用

使用指南

在 app.json 或 index.json 中引入组件

"usingComponents": {
  "van-datetime-picker": "path/to/vant-weapp/dist/datetime-picker/index"
}

代码演示

选择完整时间

<van-datetime-picker
  type="datetime"
  value="{{ currentDate }}"
  min-date="{{ minDate }}"
  max-date="{{ maxDate }}"
  bind:change="onChange"
/>

Page({
  data: {
    minHour: 10,
    maxHour: 20,
    minDate: new Date().getTime(),
    maxDate: new Date(2019, 10, 1).getTime(),
    currentDate: new Date().getTime()
  },
  onChange(event) {
    this.setData({
      currentDate: event.detail.value
    });
  }
});

选择日期（年月日）

<van-datetime-picker
  type="date"
  value="{{ currentDate }}"
  min-date="{{ minDate }}"
  bind:change="onChange"
/>

Page({
  data: {
    currentDate: new Date().getTime(),
    minDate: new Date().getTime()
  },
  onChange(event) {
    this.setData({
      currentDate: event.detail.value
    });
  }
});

选择日期（年月）

<van-datetime-picker
  type="year-month"
  value="{{ currentDate }}"
  min-date="{{ minDate }}"
  bind:change="onChange"
/>

Page({
  data: {
    currentDate: new Date().getTime(),
    minDate: new Date().getTime()
  },
  onChange(event) {
    this.setData({
      currentDate: event.detail.value
    });
  }
});

选择时间

<van-datetime-picker
  type="time"
  value="{{ currentDate }}"
  min-hour="{{ minHour }}"
  max-hour="{{ maxHour }}"
  bind:change="onChange"
/>

Page({
  data: {
    currentDate: '12:00',
    minHour: 9,
    maxHour: 23
  },
  onChange(event) {
    this.setData({
      currentDate: event.detail.value
    });
  }
});

API

参数	说明	类型	默认值
type	类型，可选值为 date time year-month	String	datetime
min-date	可选的最小时间，精确到分钟	Number	十年前
max-date	可选的最大时间，精确到分钟	Number	十年后
min-hour	可选的最小小时，针对 time 类型	Number	0
max-hour	可选的最大小时，针对 time 类型	Number	23
min-minute	可选的最小分钟，针对 time 类型	Number	0
max-minute	可选的最大分钟，针对 time 类型	Number	59
title	顶部栏标题	String	''
show-toolbar	是否显示顶部栏	Boolean	false
loading	是否显示加载状态	Boolean	false
item-height	选项高度	Number	44
confirm-button-text	确认按钮文字	String	确认
cancel-button-text	取消按钮文字	String	取消
visible-item-count	可见的选项个数	Number	5

Event

事件名称	说明	回调参数
input	当值变化时触发的事件	当前 value
change	当值变化时触发的事件	组件实例
confirm	点击完成按钮时触发的事件	当前 value
cancel	点击取消按钮时触发的事件	-

change事件

在change事件中，可以获取到组件实例，对组件进行相应的更新等操作：

函数	说明
getColumnValue(index)	获取对应列中选中的值
setColumnValue(index, value)	设置对应列中选中的值
getColumnValues(index)	获取对应列中所有的备选值
setColumnValues(index, values)	设置对应列中所有的备选值
getValues()	获取所有列中被选中的值，返回一个数组
setValues(values)	values为一个数组，设置所有列中被选中的值