跳到主要内容

TimePicker 时间选择器 ​

uni-appH5微信小程序App

封装 uni-app 原生 time picker 的跨端时间选择器。

何时使用 ​

需要用户选择一个具体时刻:预约时间、营业时间、提醒时间等。

何时不使用 ​

需要时间范围或精确到秒的场景(本组件仅 HH:mm);移动端原生时间输入更合适时用原生 input[type=time]。

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

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

Props ​

名称类型默认值说明
modelValuestring | nullnull绑定值,格式 'HH:mm',配合 v-model 使用
labelstring""选择器上方标签文本
placeholderstring"请选择时间"占位文本
minstring""可选最小时间,格式 HH:mm
maxstring""可选最大时间,格式 HH:mm
disabledbooleanfalse禁用
clearablebooleanfalse可清空(有值时 hover 显示清空按钮)
stepnumber30分钟步长,如 30 表示 00/30,15 表示 00/15/30/45

Events ​

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

示例 ​

基础用法 ​

vue
<TimePicker v-model="time" label="提醒时间" />

禁用 ​

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

限定范围 ​

vue
<TimePicker v-model="time" label="营业时间" min="08:00" max="22:00" />

清空与分钟步长 ​

vue
<TimePicker v-model="time" label="预约时间" clearable :step="15" />