用于选择或输入日期
可用时间范围是 00:00-23:59
TIP
在 SSR 场景下,您需要将组件包裹在 <client-only></client-only> 之中 (如: Nuxt) 和 SSG (例如: VitePress).
固定时间点#
提供几个固定的时间点供用户选择
使用 el-time-select 标签,然后通过start、end和step指定起始时间,结束时间和步长。
Select time
时间格式#
使用 format 属性来控制时间格式 (小时以及分钟)。
在 这里 查看 Day.js 支持的 format 参数。
WARNING
请一定要注意传入参数的大小写是否正确
Select time
固定时间范围#
如果先选中了开始(或结束)时间,则结束(或开始)时间的状态也将会随之改变。
Start time
End time
API#
Attributes#
| 属性名 | 说明 | 类型 | 默认值 |
| model-value / v-model | 选中项绑定值 | string |
— |
| disabled | 禁用状态 | boolean |
false |
| editable | 文本框可输入 | boolean |
true |
| clearable | 是否显示清除按钮 | boolean |
true |
| size | 输入框尺寸 | enum |
default |
| placeholder | 非范围选择时的占位内容 | string |
— |
| name | 原生属性 | string |
— |
| effect | Tooltip 主题,内置了 dark / light 两种主题 |
string / enum |
light |
| prefix-icon | 自定义前缀图标 | string / Component |
Clock |
| clear-icon | 自定义清除图标 | string / Component |
CircleClose |
| start | 开始时间 | string |
09:00 |
| end | 结束时间 | string |
18:00 |
| step | 间隔时间 | string |
00:30 |
| min-time | 最早时间点,早于该时间的时间段将被禁用 | string |
— |
| max-time | 最晚时间点,晚于该时间的时间段将被禁用 | string |
— |
| format | 设置时间格式 | string see formats |
HH:mm |
Events#
| 事件名 | 说明 | 类型 |
| change | 用户确认选定的值时触发 | Function |
| blur | 在组件 Input 失去焦点时触发 | Function |
| focus | 在组件 Input 获得焦点时触发 | Function |
Exposes#
| 方法名 | 说明 | 类型 |
| focus | 使 input 获取焦点 | Function |
| blur | 使 input 失去焦点 | Function |