DatetimePicker 时间选择
时间选择组件通常与 弹出层 组件配合使用
使用指南
在 app.json 或 index.json 中引入组件
"usingComponents": {
"van-datetime-picker": "path/to/vant-weapp/dist/datetime-picker/index"
}
代码演示
选择完整时间
value
为时间戳
<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
});
}
});
选择日期(年月日)
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
});
}
});
选择日期(年月)
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
});
}
});
选择时间
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
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
value | 当前选中值 | String | Number | - |
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 为一个数组,设置所有列中被选中的值 |