跳到主要内容

TimeSelect 时间选择 ​

uni-appH5微信小程序App

跨端时间档位选择器,支持起止时间和间隔步长。

何时使用 ​

从一组固定间隔的时间点中选择:预约时段、配送时间、排班整点。

何时不使用 ​

需要任意时刻(含分钟自由输入)用 TimePicker;需要日期+时间用 DatePicker。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
TimeSelect 时间选择 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
modelValuestring | nullnull绑定值,格式 'HH:mm',配合 v-model 使用
startstring"08:00"起始时间(含),格式 'HH:mm'
endstring"18:00"结束时间(含),格式 'HH:mm'
stepstring"00:30"间隔步长,格式 'HH:mm',如 '00:15' 表示每 15 分钟一档
labelstring""选择器上方标签文本
placeholderstring"请选择时间"占位文本
disabledbooleanfalse禁用
clearablebooleanfalse可清空(有值时 hover 显示清空按钮)
minTimestring-可选最小时间(含),格式 'HH:mm',之外的选项禁用
maxTimestring-可选最大时间(含),格式 'HH:mm',之外的选项禁用

Events ​

名称载荷说明
update:modelValuestring选中或清空时间时触发
clearvoid点击清空按钮时触发
changestring | null选中或清空时间时触发

示例 ​

营业时间槽 ​

vue
<TimeSelect v-model="time" label="到店时间" />

自定义步长 ​

vue
<TimeSelect v-model="time" label="会议时间" start="09:00" end="21:00" step="01:00" />

禁用 ​

vue
<TimeSelect v-model="time" label="禁用" disabled />

可选时间范围 ​

vue
<TimeSelect v-model="m1" label="到店时间" min-time="09:00" max-time="18:00" clearable />