DateTimePicker 日期时间选择器

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

提示

DateTimePicker 由 DatePicker 和 TimePicker 派生。有关属性的更详细说明,可以参考 DatePicker 和 TimePicker。

日期和时间

通过设置 typedatetime,可以在一个选择器中同时选择日期和时间。快捷选项的使用方式与 Date Picker 相同。

默认值
带快捷选项
带有默认时间

日期时间格式

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

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

在此处查看 Day.js 所有可用格式的列表

警告

注意大小写

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

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

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

-

日期和时间范围

通过设置 typedatetimerange,可以进行日期和时间范围的选择。

默认值
带快捷选项

单面板 2.14.0

默认情况下,日期选择器范围有两个面板。如果您需要单个面板,请设置 single-panel 属性。

single-panel
-

开始和结束日期的默认时间值

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

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

自定义图标 2.8.0

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

-

API

属性

名称描述类型默认值
model-value / v-model绑定值,如果它是一个 range 选择器,数组的长度应该是 2number / string / Date / array''
只读日期选择器是否只读booleanfalse
disabledDatePicker 是否被禁用booleanfalse
可编辑输入框是否可编辑booleantrue
可清空是否显示清除按钮booleantrue
size输入框尺寸枚举default
占位符非范围选择时的占位内容string
start-placeholder范围模式下开始日期的占位符string
end-placeholder范围模式下结束日期的占位符string
arrow-control是否使用箭头按钮选择时间booleanfalse
type选择器类型枚举
format输入框中显示值的格式string 详见 日期格式YYYY-MM-DD HH:mm:ss
popper-classDateTimePicker 下拉框的自定义类名string
popper-styleDateTimePicker 下拉框的自定义样式string / object
popper-options自定义 popper 选项,详见 popper.jsobject{}
fallback-placements 2.8.4文字提示可能出现的位置列表 popper.jsarray['bottom', 'top', 'right', 'left']
placement 2.8.4下拉框出现的位置位置bottom
range-separator选择范围时的分隔符string'-'
default-value可选,选择器打开时默认显示的时间object
默认时间选择日期后的默认时间值。如果没有指定,将使用时间 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 / array
名称与原生输入框的 `name` 相同string
取消面板链接在范围选择器中取消两个日期面板的链接booleanfalse
single-panel 2.14.0在范围选择器中仅显示一个面板booleanfalse
前缀图标自定义前缀图标组件string / Component日期
clear-icon自定义清除图标组件string / ComponentCircleClose
快捷选项设置快捷选项的对象数组array
禁用日期一个用来判断该日期是否被禁用的函数,接受一个日期作为参数。应该返回一个布尔值Function
disabled-hours指定不能选择的小时数组Function
disabled-minutes指定不能选择的分钟数组Function
disabled-seconds指定不能选择的秒数组Function
单元格类名设置自定义的类名Function
teleported日期时间选择器的下拉框是否通过 teleport 追加到 bodybooleantrue
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是否显示页脚,其中日期选择器是 enum 类型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
日历更改本日历所选日期发生更改时触发。 仅适用于 rangeFunction
面板更改在点击导航按钮时触发。Function
visible-change当 DateTimePicker 的下拉框出现/消失时触发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

类型声明

显示声明
ts
type Placement =
  | 'top'
  | 'top-start'
  | 'top-end'
  | 'bottom'
  | 'bottom-start'
  | 'bottom-end'
  | 'left'
  | 'left-start'
  | 'left-end'
  | 'right'
  | 'right-start'
  | 'right-end'

来源

文档