Skip to content

TimePicker 时间选择框

在弹出面板上选择时间,以便捷完成时间输入的控件。

基础用法

输入框的基本用法。

范围选择器

时间输入器的范围选择器。

~

双向绑定

支持 v-model 进行数据的双向绑定。

允许清除

通过设置 allow-clear,显示清除按钮。

~

默认值

只有默认值的情况,可通过 defaultValue 传递。

~

禁用

禁用状态。

~

禁用部分时间选项

通过设置 disabledHours、disabledMinutes、disabledSeconds,可以禁用 时 / 分 / 秒的部分选项。

~

跳过确认

跳过确认步骤,直接点击选择时间。

~

定制格式

通过设置 format,可以定制需要显示的时、分、秒。

~

定制步长

通过设置 step,可以定制需要显示的时、分、秒的步长。

附加内容

选择框底部显示自定义的内容。

十二小时制

通过设置 use12Hours,可以定制需要显示的时、分、秒。

~

不同尺寸

tu-time-picker 组件提供除了默认值 medium 以外的三种尺寸。额外的尺寸:large、small、mini,通过设置 size 属性来配置它们。

时间选择

时间范围选择

~
~
~
~

Time-Picker API

Time-Picker Attributes

参数名描述类型默认值
type选择器类型Stringtime
model-value / v-model绑定值String Number Date Array-
default-value默认值String Number Date Array-
disabled是否禁用Booleanfalse
allow-clear是否允许清除Booleanfalse
readonly是否为只读模式Booleanfalse
format展示日期的格式,参考字符串解析格式StringHH:mm:ss
placeholder提示文案String-
size输入框尺寸Stringmedium
popup-container弹出框的挂载容器String HTMLElement-
use12-hours12 小时制Booleanfalse
step设置 时/分/秒 的选择间隔Object-
disabled-hours禁用的部分小时选项Function-
disabled-minutes禁用的部分分钟选项Function-
disabled-seconds禁用的部分秒数选项Function-
hide-disabled-options隐藏禁止选择的选项Booleanfalse
disable-confirm禁用确认步骤,开启后直接点选时间不需要点击确认按钮Booleanfalse
position弹出的位置Stringbl
popup-visible控制弹出框打开或者关闭Boolean-
default-popup-visible弹出框默认打开或者关闭Booleanfalse
trigger-props可以传入 Trigger 组件的参数TriggerProps-
unmount-on-close是否在关闭后销毁 dom 结构Booleanfalse

Time-Picker Events

事件名描述参数
change组件值发生改变Function
select选择时间但未触发组件值变化Function
clear点击清除按钮-
popup-visible-change弹出框展开和收起Function

Time-Picker Slots

参数名描述
prefix输入框前缀
suffix-icon输入框后缀图标
extra额外的页脚

字符串解析格式

格式输出描述
YY21两位数的年份
YYYY2021四位数年份
M1-12月份,从 1 开始
MM01-12月份,两位数
MMMJan-Dec缩写的月份名称
MMMMJanuary-December完整的月份名称
D1-31月份里的一天
DD01-31月份里的一天,两位数
d0-6一周中的一天,星期天是 0
ddSu-Sa最简写的一周中一天的名称
dddSun-Sat简写的一周中一天的名称
ddddSunday-Saturday一周中一天的名称
H0-23小时
HH00-23小时,两位数
h1-12小时, 12 小时制
hh01-12小时, 12 小时制, 两位数
m0-59分钟
mm00-59分钟,两位数
s0-59
ss00-59秒,两位数
S0-9数百毫秒,一位数
SS00-99几十毫秒,两位数
SSS000-999毫秒,三位数字
Z-5:00UTC 的偏移量
ZZ-0500UTC 的偏移量,数字前面加上 0
AAM PM-
aam pm-
Do1st... 3st带序号的月份中的某天
X1410715640.579Unix 时间戳
x1410715640579Unix 毫秒时间戳