Tui

DatePicker 日期选择器
用于选择单个日期或日期时间。
基础用法
默认使用 YYYY-MM-DD HH:mm:ss 格式。
示例代码
vue
格式与状态组合
合并演示 formatneedConfirmclearabledisabled
日期格式(YYYY-MM-DD)
不展示时间面板,返回纯日期字符串。
即时提交(needConfirm=false)
选择日期后立即提交,不需要再点击确认。
禁用状态
只展示当前值,不允许交互与修改。
示例代码
vue
属性 Props
属性名
说明
类型
可选值
默认值
版本说明
modelValue / v-model
绑定值
string | Date
''
changed 0.6.0
defaultValue
默认值(非受控模式)
string | Date
''
changed 0.6.0
placeholder
输入框占位符
string
'请选择日期'
changed 0.6.0
placements
弹出框位置
Placement[]
['bottom-start','top-start','bottom-end','top-end','right-center','left-center']
changed 0.6.7
clearable
是否显示清除按钮
boolean
false
disabled
是否禁用
boolean
false
needConfirm
是否需要确认按钮
boolean
true
added 0.6.0
format
值格式(仅支持日期 / 日期时间)
'YYYY-MM-DD' | 'YYYY-MM-DD HH:mm:ss'
YYYY-MM-DD HH:mm:ss
changed 0.6.7
事件 Events
事件名
说明
回调参数
版本说明
change
值变化时触发
(value: string)
基础用法
格式与状态组合
属性 Props
事件 Events