Pro 日期时间选择器
在同一个选择器中选择日期 + 时刻。仅选日期见 DatePicker Pro,仅选时刻见 TimePicker Pro。
组件选型
| 组件 | 适用场景 |
|---|---|
| DatePicker Pro | 仅日期、日期范围(无时刻) |
| DateTimePicker Pro(本文档) | datetime 单点、datetimerange 范围 |
| TimePicker Pro | 仅时刻 |
| DatePickerPanel Pro | 独立面板(含 datetime / datetimerange) |
由日期面板与时间列组合而成,属性说明亦可参考 DatePicker Pro 与 TimePicker 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
-
格式
输入框:format 与 value-format
Emits Date object
Value:
Use value-format
Value:
Timestamp
Value:
使用 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 |
API
文档站中的 DateTimePicker Pro 即 w-date-picker-pro,将 type 设为 datetime 或 datetimerange 使用。
属性、事件、插槽、暴露方法 与 DatePicker Pro 完全一致,请参阅该页 API 表格。
与日期选择相关的补充说明
| 项目 | 说明 |
|---|---|
type | 常用 datetime、datetimerange |
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 版权所有

