DatetimePicker 时间选择

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

使用指南

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

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

代码演示

选择完整时间

value 为时间戳

  1. <van-datetime-picker
  2. type="datetime"
  3. value="{{ currentDate }}"
  4. min-date="{{ minDate }}"
  5. max-date="{{ maxDate }}"
  6. bind:change="onChange"
  7. />
  1. Page({
  2. data: {
  3. minHour: 10,
  4. maxHour: 20,
  5. minDate: new Date().getTime(),
  6. maxDate: new Date(2019, 10, 1).getTime(),
  7. currentDate: new Date().getTime()
  8. },
  9. onChange(event) {
  10. this.setData({
  11. currentDate: event.detail.value
  12. });
  13. }
  14. });

选择日期(年月日)

value 为时间戳

  1. <van-datetime-picker
  2. type="date"
  3. value="{{ currentDate }}"
  4. min-date="{{ minDate }}"
  5. bind:change="onChange"
  6. />
  1. Page({
  2. data: {
  3. currentDate: new Date().getTime(),
  4. minDate: new Date().getTime()
  5. },
  6. onChange(event) {
  7. this.setData({
  8. currentDate: event.detail.value
  9. });
  10. }
  11. });

选择日期(年月)

value 为时间戳

  1. <van-datetime-picker
  2. type="year-month"
  3. value="{{ currentDate }}"
  4. min-date="{{ minDate }}"
  5. bind:change="onChange"
  6. />
  1. Page({
  2. data: {
  3. currentDate: new Date().getTime(),
  4. minDate: new Date().getTime()
  5. },
  6. onChange(event) {
  7. this.setData({
  8. currentDate: event.detail.value
  9. });
  10. }
  11. });

选择时间

value 为字符串

  1. <van-datetime-picker
  2. type="time"
  3. value="{{ currentDate }}"
  4. min-hour="{{ minHour }}"
  5. max-hour="{{ maxHour }}"
  6. bind:change="onChange"
  7. />
  1. Page({
  2. data: {
  3. currentDate: '12:00',
  4. minHour: 9,
  5. maxHour: 23
  6. },
  7. onChange(event) {
  8. this.setData({
  9. currentDate: event.detail.value
  10. });
  11. }
  12. });

API

参数说明类型默认值
value当前选中值String | Number-
type类型,可选值为 date time year-month 不建议动态修改Stringdatetime
min-date可选的最小时间,精确到分钟Number十年前
max-date可选的最大时间,精确到分钟Number十年后
min-hour可选的最小小时,针对 time 类型Number0
max-hour可选的最大小时,针对 time 类型Number23
min-minute可选的最小分钟,针对 time 类型Number0
max-minute可选的最大分钟,针对 time 类型Number59
title顶部栏标题String''
show-toolbar是否显示顶部栏Booleanfalse
loading是否显示加载状态Booleanfalse
item-height选项高度Number44
confirm-button-text确认按钮文字String确认
cancel-button-text取消按钮文字String取消
visible-item-count可见的选项个数Number5

Event

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

change事件

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

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

原文: https://youzan.github.io/vant-weapp/#/datetime-picker