Skip to content

Time 时间选择器

选择时间的组件。

何时使用

当用户需要输入一个时间,可以点击输入框弹出时间面板进行选择。

基础用法

点击输入框弹出时间选择面板,支持时、分选择。通过 v-model 绑定时间值(格式 HH:mm)。

vue

<TTime v-model="time" placeholder="请选择时间" />

预设值

传入预设时间值,面板初始化时自动定位到对应位置。

vue

<TTime :model-value="'14:30'" />

带秒选择

设置 format="HH:mm:ss" 显示秒列,支持时、分、秒完整选择。

vue

<TTime :model-value="'09:15:30'" format="HH:mm:ss" />

分钟步长

设置 minute-step 属性控制分钟选项的递增步长,可选 5、10、15、30 等。

vue

<TTime :minute-step="15" placeholder="步长15分钟" />

尺寸

支持 sm、默认、lg 三种尺寸。

vue

<TTime size="sm" placeholder="小尺寸" />
<TTime placeholder="默认尺寸" />
<TTime size="lg" placeholder="大尺寸" />

可清除

设置 clearable 后,面板底部显示清除按钮,可一键清空已选时间。

vue

<TTime :model-value="'10:00'" clearable />

禁用

设置 disabled 禁用时间选择。

vue

<TTime disabled placeholder="禁用状态" />

API

TTime 属性 (Props)

属性名说明类型默认值
model-value时间值(v-model 绑定,格式 HH:mmHH:mm:ssstring''
format显示格式'HH:mm' | 'HH:mm:ss''HH:mm'
hour-step小时步长number1
minute-step分钟步长number1
second-step秒步长number1
disabled是否禁用booleanfalse
placeholder占位符文本string'选择时间'
size尺寸'sm' | 'lg'undefined
clearable是否显示清除按钮booleanfalse

TTime 事件 (Emits)

事件名说明回调参数
update:model-value时间值变化时触发(value: string) => void
change用户确认选择时触发(value: string) => void