日期时间选择器
在一个选择器中选择日期和时间。
提示
DateTimePicker 组件派生自 DatePicker 和 TimePicker,因此它们的大部分属性是相同的。 关于属性的更详细解释,你可以参考 DatePicker 和 TimePicker 的文档。
日期和时间
通过设置 type
属性为 datetime
, 你可以在同一个选择器里同时进行日期和时间的选择。 快捷选项的使用方法与 Date Picker 相同。
日期时间格式
使用 format
属性可以控制输入框中显示的文本格式。 使用 value-format
属性可以控制绑定值的格式。
默认情况下,该组件接受并返回一个 Date
对象。
请在此处查看 Day.js 中所有可用的格式。
警告
注意大小写
下拉面板中的日期和时间格式
使用 date-format
和 time-format
来控制下拉面板中显示的文本格式。
日期和时间范围
通过设置 type
属性为 datetimerange
来选择日期和时间范围。
为开始和结束日期设置默认时间
当选择日期范围时,datetimerange
类型默认会使用 00:00:00
作为开始和结束日期的默认时间。 我们可以通过 default-time
属性来控制它。 default-time
接受一个最多包含两个 Date 对象的数组。 第一个控制开始日期的时间,第二个控制结束日期的时间。
自定义图标 2.8.0
可以使用插槽来自定义图标。
属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
model-value / v-model | 绑定值,如果它是数组,长度应该是 2 | number / string / object | — |
只读 | 日期选择器是否只读 | boolean | false |
disabled | 日期选择器是否被禁用 | boolean | false |
可编辑 | 输入框是否可编辑 | boolean | true |
可清空 | 是否显示清除按钮 | boolean | true |
size | 输入框尺寸 | 枚举 | default |
占位符 | 非范围选择时的占位内容 | string | — |
start-placeholder | 范围模式下开始日期的占位符 | string | — |
end-placeholder | 范围模式下结束日期的占位符 | string | — |
arrow-control | 是否使用箭头按钮来选择时间 | boolean | false |
type | 选择器的类型 | 枚举 | date |
format | 输入框中显示值的格式 | string 见 日期格式 | YYYY-MM-DD HH:mm:ss |
popper-class | 日期时间选择器下拉列表的自定义类名 | string | — |
popper-style | 日期时间选择器下拉列表的自定义样式 | string / object | — |
range-separator | 选择范围时的分隔符 | string | '-' |
default-value | 可选,选择器打开时默认显示的时间 | object | — |
default-time | 选择日期后的默认时间值。 如果未指定,则将使用时间 00:00:00 | object | — |
value-format | 可选,绑定值的格式。 如果未指定,则绑定值为 Date 对象 | string 查看 日期格式 | — |
date-format 2.4.0 | 可选,在输入框内部面板中显示的日期格式 | string 查看 日期格式 | YYYY-MM-DD |
time-format 2.4.0 | 可选,在输入框内部面板中显示的时间格式 | string 查看 日期格式 | HH:mm:ss |
id | 与原生 input 的 `id` 属性相同 | string / object | — |
名称 | 与原生输入框的 `name` 相同 | string | — |
unlink-panels | 在范围选择器中取消两个日期面板的联动 | boolean | false |
前缀图标 | 自定义前缀图标组件 | string / Component | 日期 |
clear-icon | 自定义清空图标组件 | string / Component | CircleClose |
shortcuts | 一个对象数组,用于设置快捷选项 | object | — |
disabled-date | 一个用来判断该日期是否被禁用的函数,参数为当前日期。 应该返回一个布尔值 | Function | — |
disabled-hours | 用于指定无法选择的小时数组 | Function | — |
disabled-minutes | 用于指定无法选择的分钟数组 | Function | — |
disabled-seconds | 用于指定无法选择的秒数组 | Function | — |
cell-class-name | 设置自定义类名 | Function | — |
teleported | 日期时间选择器的下拉列表是否被传送到 body 元素 | boolean | true |
empty-values 2.7.0 | 组件的空值,参见 config-provider | array | — |
value-on-clear 2.7.0 | 清除后的返回值,参见 config-provider | string / number / boolean / Function | — |
show-now 2.8.7 | 是否显示此刻按钮 | boolean | true |
show-footer 2.10.5 | 是否显示页脚 | boolean | true |
show-confirm 2.11.0 | 是否显示确认按钮 | boolean | true |
show-week-number 2.10.3 | 在一周旁边显示周数 | boolean | false |
事件
名称 | 描述 | 参数 |
---|---|---|
change | 当用户确认值或点击外部时触发 | Function |
blur | 在 Input 失去焦点时触发 | Function |
focus | 在 Input 获得焦点时触发 | Function |
clear 2.7.7 | 在可清除的日期时间选择器中单击清除图标时触发 | Function |
calendar-change | 当所选日历的日期更改时触发。 仅适用于 range | Function |
panel-change | 导航按钮点击时触发 | Function |
visible-change | 在日期时间选择器的下拉列表出现/消失时触发 | Function |
插槽
名称 | 描述 |
---|---|
default | 自定义单元格内容 |
range-separator | 自定义范围分隔符内容 |
prev-month 2.8.0 | 上个月图标 |
next-month 2.8.0 | 下个月图标 |
prev-year 2.8.0 | 上一年图标 |
next-year 2.8.0 | 下一年图标 |
暴露
方法 | 描述 | 类型 |
---|---|---|
focus | 聚焦日期选择器组件 | Function |
blur 2.8.7 | 使日期选择器组件失焦 | Function |