日期时间选择器

在同一个选择器中选择日期 + 时刻(经典版,范围默认双面板)。推荐 DateTimePicker Pro

组件选型

组件说明
DatePicker仅日期
DateTimePicker(本文档)datetime / datetimerange
TimePicker仅时刻
DatePickerPanel独立面板

由日期选择器与时间选择器组合,属性亦可参考 DatePickerTimePicker

单点选择

日期时间 datetime

type="datetime";快捷项用法同 DatePicker。

默认
带快捷选项
默认时间
轻量化

范围选择

默认左右双面板联动unlink-panels 可解除联动。

日期时间范围 datetimerange

默认
-
带快捷选项
-

范围默认时刻 default-time

选中范围日期后,默认时刻为 00:00:00default-time[开始时刻, 结束时刻]

默认时间为 12:00:00
-
开始时间 12:00:00, 结束时间 08:00:00
-

格式

输入框:formatvalue-format

使用 format / value-format 控制输入框与绑定值;默认为 Date

Day.js 格式说明

格式输出描述
YY18两位数的年份
YYYY2018四位数的年份
M1-12月份,从 1 开始
MM01-12月份,两位数
MMMJan-Dec简写的月份名称
MMMMJanuary-December完整的月份名称
D1-31月份里的一天
DD01-31月份里的一天,两位数
d0-6一周中的一天,星期天是 0
ddSu-Sa最简写的一周中一天的名称
dddSun-Sat简写的一周中一天的名称
ddddSunday-Saturday一周中一天的名称
H0-23小时
HH00-23小时,两位数
h1-12小时, 12 小时制
hh01-12Hours, 12 小时制, 两位数
m0-59分钟
mm00-59分钟,两位数
s0-59
ss00-59秒 两位数
SSS000-999毫秒 三位数
Z+5:00UTC 的偏移量
ZZ+0500UTC 的偏移量,数字前面加上 0
AAM PM
aam pm

WARNING

请一定要注意传入参数的大小写是否正确

Emits Date object
Value:
Use value-format
Value:
Timestamp
Value:

面板内:date-formattime-format

-

自定义

图标插槽

-

API

Attributes

参数说明类型默认值Version
model-value / v-model绑定值,如果它是数组,长度应该是 2number / string / Date / array
readonly只读booleanfalse
disabled禁用booleanfalse
editable文本框可输入booleantrue
clearable是否显示清除按钮booleantrue
size输入框尺寸enumdefault
placeholder非范围选择时的占位内容string
start-placeholder范围选择时开始日期的占位内容string
end-placeholder范围选择时结束日期的占位内容string
arrow-control是否使用箭头进行时间选择booleanfalse
type显示类型enumdate
format显示在输入框中的格式string 参见 格式与绑定值type 默认
popper-classDateTimePicker 下拉框的类名string
teleported是否使用 teleport;为 true 时下拉层挂载到 append-to 指定位置booleantrue
append-to下拉层挂载到哪个 DOM 元素string
range-separator选择范围时的分隔符string'-'
default-value可选,选择器打开时默认显示的时间object
default-time选择日期后的默认时间值。 如未指定则默认时间值为 00:00:00object
value-format可选,绑定值的格式。 不指定则绑定值为 Date 对象string see date formats
date-format可选,时间选择器下拉列表中显示的日期格式string see date formats
time-format可选,时间选择器下拉列表中显示的时间格式string see date formats
id等价于原生 input id 属性string / object
name等价于原生 input name 属性string
unlink-panels在范围选择器里取消两个日期面板之间的联动booleanfalse
prefix-icon自定义前缀图标组件string / Component
clear-icon自定义清除图标string / ComponentCircleCloseFilled
shortcuts设置快捷选项,需要传入数组对象object
disabled-date一个用来判断该日期是否被禁用的函数,接受一个 Date 对象作为参数。 应该返回一个 Boolean 值。Function
cell-class-name设置自定义类名Function
empty-values组件的空值配置 参考 config-providerarray
value-on-clear清空选项的值 参考 config-providerstring / number / boolean / Function
show-now是否显示 now 按钮booleantrue
plain朴素的 DatePickerbooleanfalseV0.0.8
emit-formatted-valuechange 事件是否附带格式化字符串(第二参数)booleanfalseV0.0.8

事件

事件名说明回调参数
change用户确认选定的值时触发value
blur在组件 Input 失去焦点时触发(e: FocusEvent)
focus在组件 Input 获得焦点时触发(e: FocusEvent)
clear可清空的模式下用户点击清空按钮时触发Function
calendar-change如果用户没有选择日期,那默认展示当前日的月份。 选中日历日期后会执行的回调,只有当 datetimerange 才生效[Date, Date]
visible-change当 DateTimePicker 的下拉列表出现/消失时触发出现时为 true,隐藏时为 false

Slots

插槽名说明
default自定义单元格内容
range-separator自定义范围分割符内容
prev-month上个月的图标
next-month下个月的图标
prev-year上一年图标
next-year下一年图标

Exposes

方法名说明类型
focus使组件获取焦点Function
blur使组件失去焦点Function

Copyright 2025 Winning Health 版权所有