Pro 日期时间选择器

在同一个选择器中选择日期 + 时刻。仅选日期见 DatePicker Pro,仅选时刻见 TimePicker Pro

组件选型

组件适用场景
DatePicker Pro仅日期、日期范围(无时刻)
DateTimePicker Pro(本文档)datetime 单点、datetimerange 范围
TimePicker Pro仅时刻
DatePickerPanel Pro独立面板(含 datetime / datetimerange

由日期面板与时间列组合而成,属性说明亦可参考 DatePicker ProTimePicker Pro

WARNING

Pro 版面板通过虚拟滚动展示年/月列表,年份范围由 calendar-range 控制(默认当前年前后各 10 年)。若业务需要选择超出该范围的年份(如历史数据录入、出生日期),必须通过 calendar-range 显式指定 [startYear, endYear],否则超出范围的年份不可见也不可选。

单点选择

日期时间 datetime

type="datetime",同一面板内选日期与时间。快捷项用法与 DatePicker Pro 相同。

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

范围选择

日期时间范围 datetimerange

单面板 + Tab:开始 / 结束各选日期与时间;须点「下一步」进入结束侧(不会选完开始自动跳转);结束侧未改时间直接「确定」时,结束时刻与开始相同。起止先后不合法会自动对调。

默认
-
带快捷选项
-

范围默认时刻 default-time

选定起止日期后,用 default-time 写入默认时刻;数组第一项为开始、第二项为结束。也可传单个 Date,两端共用同一时刻。

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

格式

输入框:formatvalue-format

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

使用 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

API

文档站中的 DateTimePicker Prow-date-picker-pro,将 type 设为 datetimedatetimerange 使用。

属性、事件、插槽、暴露方法DatePicker Pro 完全一致,请参阅该页 API 表格。

与日期选择相关的补充说明

项目说明
type常用 datetimedatetimerange
format 默认YYYY-MM-DD HH:mm:ss
suffix-icon 默认时钟图标(Time
default-time范围选中日期的默认时刻,未指定时为 00:00:00
disabled-hours / disabled-minutes / disabled-seconds禁用部分时刻
arrow-control / show-now面板时间列与页脚「此刻」
calendar-change主要在 datetimerange 下,选中日历日期时触发

Copyright 2025 Winning Health 版权所有