Skip to content

Time

Time picker component.

When to Use

Use when users need to input or select a time value.

Basic Usage

Click the input to open the time selection panel. Use v-model to bind the time value (format HH:mm).

vue

<TTime v-model="time" placeholder="Select time" />

Preset Value

Pass a preset time value.

vue

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

With Seconds

Set format="HH:mm:ss" to show the seconds column.

vue

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

Minute Step

Set minute-step to control the minute increment (5, 10, 15, 30, etc.).

vue

<TTime :minute-step="15" placeholder="15 min step" />

Sizes

Supports sm, default, and lg sizes.

vue

<TTime size="sm" placeholder="Small" />
<TTime placeholder="Default" />
<TTime size="lg" placeholder="Large" />

Clearable

Set clearable to show a clear button in the panel footer.

vue

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

Disabled

Set disabled to disable time selection.

vue

<TTime disabled placeholder="Disabled" />

API

TTime Props

PropDescriptionTypeDefault
model-valueTime value (v-model, format HH:mm or HH:mm:ss)string''
formatDisplay format'HH:mm' | 'HH:mm:ss''HH:mm'
hour-stepHour stepnumber1
minute-stepMinute stepnumber1
second-stepSecond stepnumber1
disabledDisabled statebooleanfalse
placeholderPlaceholder textstring'Select time'
sizeSize'sm' | 'lg'undefined
clearableShow clear buttonbooleanfalse

TTime Events

EventDescriptionParameters
update:model-valueEmitted when time value changes(value: string) => void
changeEmitted when user confirms selection(value: string) => void