日期时间选择器
在同一个选择器中选择日期 + 时刻(经典版,范围默认双面板)。推荐 DateTimePicker Pro。
组件选型
| 组件 | 说明 |
|---|---|
| DatePicker | 仅日期 |
| DateTimePicker(本文档) | datetime / datetimerange |
| TimePicker | 仅时刻 |
| DatePickerPanel | 独立面板 |
由日期选择器与时间选择器组合,属性亦可参考 DatePicker 与 TimePicker。
单点选择
日期时间 datetime
type="datetime";快捷项用法同 DatePicker。
默认
带快捷选项
默认时间
轻量化
范围选择
默认左右双面板联动,unlink-panels 可解除联动。
日期时间范围 datetimerange
默认
-
带快捷选项
-
范围默认时刻 default-time
选中范围日期后,默认时刻为 00:00:00;default-time 为 [开始时刻, 结束时刻]。
默认时间为 12:00:00
-
开始时间 12:00:00, 结束时间 08:00:00
-
格式
输入框:format 与 value-format
使用 format / value-format 控制输入框与绑定值;默认为 Date。
| 格式 | 输出 | 描述 |
|---|---|---|
YY | 18 | 两位数的年份 |
YYYY | 2018 | 四位数的年份 |
M | 1-12 | 月份,从 1 开始 |
MM | 01-12 | 月份,两位数 |
MMM | Jan-Dec | 简写的月份名称 |
MMMM | January-December | 完整的月份名称 |
D | 1-31 | 月份里的一天 |
DD | 01-31 | 月份里的一天,两位数 |
d | 0-6 | 一周中的一天,星期天是 0 |
dd | Su-Sa | 最简写的一周中一天的名称 |
ddd | Sun-Sat | 简写的一周中一天的名称 |
dddd | Sunday-Saturday | 一周中一天的名称 |
H | 0-23 | 小时 |
HH | 00-23 | 小时,两位数 |
h | 1-12 | 小时, 12 小时制 |
hh | 01-12 | Hours, 12 小时制, 两位数 |
m | 0-59 | 分钟 |
mm | 00-59 | 分钟,两位数 |
s | 0-59 | 秒 |
ss | 00-59 | 秒 两位数 |
SSS | 000-999 | 毫秒 三位数 |
Z | +5:00 | UTC 的偏移量 |
ZZ | +0500 | UTC 的偏移量,数字前面加上 0 |
A | AM PM | |
a | am pm |
WARNING
请一定要注意传入参数的大小写是否正确
Emits Date object
Value:
Use value-format
Value:
Timestamp
Value:
面板内:date-format 与 time-format
-
自定义
图标插槽
API
Attributes
| 参数 | 说明 | 类型 | 默认值 | Version |
|---|---|---|---|---|
| model-value / v-model | 绑定值,如果它是数组,长度应该是 2 | number / string / Date / array | — | |
| readonly | 只读 | boolean | false | |
| disabled | 禁用 | boolean | false | |
| editable | 文本框可输入 | boolean | true | |
| clearable | 是否显示清除按钮 | boolean | true | |
| size | 输入框尺寸 | enum | default | |
| placeholder | 非范围选择时的占位内容 | string | — | |
| start-placeholder | 范围选择时开始日期的占位内容 | string | — | |
| end-placeholder | 范围选择时结束日期的占位内容 | string | — | |
| arrow-control | 是否使用箭头进行时间选择 | boolean | false | |
| type | 显示类型 | enum | date | |
| format | 显示在输入框中的格式 | string 参见 格式与绑定值 | 按 type 默认 | |
| popper-class | DateTimePicker 下拉框的类名 | string | — | |
| teleported | 是否使用 teleport;为 true 时下拉层挂载到 append-to 指定位置 | boolean | true | |
| append-to | 下拉层挂载到哪个 DOM 元素 | string | — | |
| range-separator | 选择范围时的分隔符 | string | '-' | |
| default-value | 可选,选择器打开时默认显示的时间 | object | — | |
| default-time | 选择日期后的默认时间值。 如未指定则默认时间值为 00:00:00 | object | — | |
| 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 | 在范围选择器里取消两个日期面板之间的联动 | boolean | false | |
| prefix-icon | 自定义前缀图标组件 | string / Component | ||
| clear-icon | 自定义清除图标 | string / Component | CircleCloseFilled | |
| shortcuts | 设置快捷选项,需要传入数组对象 | object | — | |
| disabled-date | 一个用来判断该日期是否被禁用的函数,接受一个 Date 对象作为参数。 应该返回一个 Boolean 值。 | Function | — | |
| cell-class-name | 设置自定义类名 | Function | — | |
| empty-values | 组件的空值配置 参考 config-provider | array | — | |
| value-on-clear | 清空选项的值 参考 config-provider | string / number / boolean / Function | — | |
| show-now | 是否显示 now 按钮 | boolean | true | |
| plain | 朴素的 DatePicker | boolean | false | V0.0.8 |
| emit-formatted-value | change 事件是否附带格式化字符串(第二参数) | boolean | false | V0.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 版权所有

