日期时间选择器

在一个选择器中选择日期和时间。

提示

DateTimePicker 组件派生自 DatePicker 和 TimePicker,因此它们的大部分属性是相同的。 关于属性的更详细解释,你可以参考 DatePicker 和 TimePicker 的文档。

日期和时间

通过设置 type 属性为 datetime, 你可以在同一个选择器里同时进行日期和时间的选择。 快捷选项的使用方法与 Date Picker 相同。

默认值
带快捷选项
设置默认时间

日期时间格式

使用 format 属性可以控制输入框中显示的文本格式。 使用 value-format 属性可以控制绑定值的格式。

默认情况下,该组件接受并返回一个 Date 对象。

在此处查看 Day.js 中所有可用的格式。

警告

注意大小写

返回 Date 对象
使用 value-format
值:
时间戳
值:

下拉面板中的日期和时间格式

使用 date-formattime-format 来控制下拉面板中显示的文本格式。

-

日期和时间范围

通过设置 type 属性为 datetimerange 来选择日期和时间范围。

默认值
带快捷选项

为开始和结束日期设置默认时间

当选择日期范围时,datetimerange 类型默认会使用 00:00:00 作为开始和结束日期的默认时间。 我们可以通过 default-time 属性来控制它。 default-time 接受一个最多包含两个 Date 对象的数组。 第一个控制开始日期的时间,第二个控制结束日期的时间。

开始和结束日期时间为 12:00:00
-
开始日期时间 12:00:00,结束日期时间 08:00:00
-

自定义图标 2.8.0

可以使用插槽来自定义图标。

-

属性

名称描述类型默认值
model-value / v-model绑定值,如果它是数组,长度应该是 2number / string / object
只读日期选择器是否只读booleanfalse
disabled日期选择器是否被禁用booleanfalse
可编辑输入框是否可编辑booleantrue
可清空是否显示清除按钮booleantrue
size输入框尺寸枚举default
占位符非范围选择时的占位内容string
start-placeholder范围模式下开始日期的占位符string
end-placeholder范围模式下结束日期的占位符string
arrow-control是否使用箭头按钮来选择时间booleanfalse
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:00object
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在范围选择器中取消两个日期面板的联动booleanfalse
前缀图标自定义前缀图标组件string / Component日期
clear-icon自定义清空图标组件string / ComponentCircleClose
shortcuts一个对象数组,用于设置快捷选项object
disabled-date一个用来判断该日期是否被禁用的函数,参数为当前日期。 应该返回一个布尔值Function
disabled-hours用于指定无法选择的小时数组Function
disabled-minutes用于指定无法选择的分钟数组Function
disabled-seconds用于指定无法选择的秒数组Function
cell-class-name设置自定义类名Function
teleported日期时间选择器的下拉列表是否被传送到 body 元素booleantrue
empty-values 2.7.0组件的空值,参见 config-providerarray
value-on-clear 2.7.0清除后的返回值,参见 config-providerstring / number / boolean / Function
show-now 2.8.7是否显示此刻按钮booleantrue
show-footer 2.10.5是否显示页脚booleantrue
show-confirm 2.11.0是否显示确认按钮booleantrue
show-week-number 2.10.3在一周旁边显示周数booleanfalse

事件

名称描述参数
change当用户确认值或点击外部时触发Function
blur在 Input 失去焦点时触发Function
focus在 Input 获得焦点时触发Function
clear 2.7.7在可清除的日期时间选择器中单击清除图标时触发Function
calendar-change当所选日历的日期更改时触发。 仅适用于 rangeFunction
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

来源

文档