Skip to content

DatePicker 时间选择框

选择日期。支持年、月、周、日类型,支持范围选择等。

基础用法

日期选择框的基础使用。

年份选择框

年份选择框的基础使用。

月份选择框

月份选择框的基础使用。

季度选择框

季度选择框的基础使用。

周选择框

周选择框的基础使用。

范围选择器

范围输入器的基础使用。

日期范围

-

周范围

-

月范围

-

季度范围

-

年范围

-

日期时间范围

-

带时间的日期选择

使用 showTime 可以使用带时间的日期选择。

显示时分

显示时分秒

时间范围

-

默认值

日期输入器有默认值的情况。

日期

自定义日期格式

日期时间

日期范围

-

月份范围

-

不可选取的时间

使用 disabledDate 可以禁用某些日期。使用 disabledTime 可以禁用时间,需要配合 showTime 使用。

日期不可选

日期范围不可选

-

日期时间不可选

日期时间范围不可选

-

预设时间快捷选择

使用 shortcuts 可以预设时间快捷选择。

日期时间

月份

日期时间范围

-

月份范围

-

定制预设范围位置

使用 shortcutsPosition 可以将预设时间快捷选择放到左边、右边或者底部。

左侧

-

右侧

-

动态控制选取范围

根据选择的值来控制选取的范围,使用 onSelect 配合 disabledDate 来实现。

可选取前后7天范围

-

额外的页脚

在浮层中加入额外的页脚,以满足某些定制信息的需求。

-

禁用

禁用状态。

-
-
-

定制日期单元格

利用具名插槽 cell 可以定制日期单元格。

双向绑定

通过 v-model 实现值的双向绑定。

日期绑定值

日期范围绑定值

-

自定义触发元素

自定义触发元素。

只使用面板

只用选择面板,不显示输入框。

2019-06
26
27
28
29
30
31
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
1
2
3
4
5
6
2019-08
28
29
30
31
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
2
3
4
5
6
7
2020-06
31
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
1
2
3
4
5
6
7
8
9
10
11

尺寸

设置 size 可以使用四种尺寸(mini small medium large)的输入框。

日期选择

日期时间

日期范围

-

Common API

Common Attributes

参数名描述类型默认值
locale国际化配置,用于覆盖locale中的 datePicker 字段Record-
hide-trigger没有触发元素,只显示选择面板Booleanfalse
allow-clear是否允许清除Booleantrue
readonly是否为只读Booleanfalse
error是否为错误状态Booleanfalse
size日期选择器的尺寸Stringmedium
shortcuts预设时间范围快捷选择Array[]
shortcuts-position预设范围在面板上的位置,默认放在下方,侧边一般用于大量预设时间的场景Stringbottom
position弹出的框的位置Stringbl
popup-visible控制弹出框的打开或者关闭状态Boolean-
default-popup-visible默认弹出框是打开或者关闭Booleanfalse
trigger-props可以传入Trigger 组件的参数TriggerProps-
unmount-on-close是否在隐藏的时候销毁DOM结构Booleanfalse
placeholder提示文案String-
disabled是否禁用Booleanfalse
disabled-date不可选取的日期Function-
disabled-time不可选取的时间Function-
picker-value(v-model)面板显示的日期DateStringNumber-
default-picker-value面板默认显示的日期DateStringNumber-
popup-container弹出框的挂载容器StringHTMLElementNullUndefined-
value-format值的格式,对 value、defaultValue、pickerValue、defaultPickerValue 以及事件中的返回值生效,支持设置为时间戳,Date 和字符串(参考字符串解析格式)。如果没有指定,将格式化为字符串,格式同 format。TimestampDateString-
preview-shortcut是否要预览快捷选择的结果Booleantrue
show-confirm-btn是否显示确认按钮,showTime 为 true 的时候始终显示。Booleanfalse
disabled-input是否禁止键盘输入日期Booleanfalse
abbreviation是否启用缩写Booleantrue

Common Events

事件名描述参数
change组件值发生改变Function
select选中日期发生改变但组件值未改变Function
popup-visible-change打开或关闭弹出框Function
ok点击确认按钮Function
clear点击清除按钮Function
select-shortcut点击快捷选项Function
picker-value-change面板日期改变Function

Date-Picker Attributes

参数名描述
prefix输入框前缀
suffix-icon输入框后缀图标
icon-next-double双箭头往后翻页图标
icon-prev-double双箭头往前翻页图标
icon-next单箭头往后翻页图标
icon-prev单箭头往前翻页图标
cell自定义日期单元格的内容
extra额外的页脚

Week-Picker Attributes

参数名描述类型默认值
v-model绑定值DateStringNumber-
default-value默认值DateStringNumber-
format展示日期的格式,参考字符串解析格式Stringgggg-wo
value-format值的格式,对value、defaultValue、pickerValue、defaultPickerValue 以及事件中的返回值生效,支持设置为时间戳,Date 和字符串(参考字符串解析格式)。StringYYYY-MM-DD
day-start-of-week每周的第一天开始于周几,0 - 周日,1 - 周一,以此类推。Number0

Quarter-Picker Attributes

参数名描述类型默认值
v-model绑定值DateStringNumber-
default-value默认值DateStringNumber-
format展示日期的格式,参考字符串解析格式StringYYYY-MM
value-format值的格式,对value、defaultValue、pickerValue、defaultPickerValue 以及事件中的返回值生效,支持设置为时间戳,Date 和字符串(参考字符串解析格式)。StringYYYY-MM

Month-Picker Attributes

参数名描述类型默认值
model-value / v-model绑定值DateStringNumber-
default-value默认值DateStringNumber-
format展示日期的格式,参考字符串解析格式StringYYYY-MM

Year-Picker Attributes

参数名描述类型默认值
model-value / v-model绑定值DateStringNumber-
default-value默认值DateStringNumber-
format展示日期的格式,参考字符串解析格式StringYYYY

Range-Picker Attributes

参数名描述类型默认值
mode范围选择器的类型Stringdate
v-model绑定值Array-
default-value默认值Array-
picker-value默认面板显示的日期Array-
default-picker-value面板显示的日期Array-
disabled是否禁用BooleanArrayfalse
day-start-of-week每周的第一天开始于周几,0 - 周日,1 - 周一,以此类推。Number0
format展示日期的格式,参考字符串解析格式String-
value-format值的格式,对value、defaultValue、pickerValue、defaultPickerValue 以及事件中的返回值生效,支持设置为时间戳,Date 和字符串(参考字符串解析格式)。如果没有指定,将格式化为字符串,格式同 format。TimestampDateString-
show-time是否增加时间选择Booleanfalse
time-picker-props时间显示的参数Object-
placeholder提示文案Array-
disabled-date不可选的日期Function-
disabled-time不可选取的时间Function-
separator范围选择器输入框内的分割符号String-
exchange-time时间是否会交换,默认情况下时间会影响和参与开始和结束值的排序,如果要固定时间顺序,可将其关闭。Stringtrue
disabled-input是否禁止键盘输入日期Booleanfalse
abbreviation是否启用缩写Booleantrue

Range-Picker Events

事件名描述参数
change组件值发生改变Function
select选中日期发生改变但组件值未改变Function
popup-visible-change打开或关闭弹出框Function
ok点击确认按钮Function
clear点击清除按钮Function
select-shortcut点击快捷选项Function
picker-value-change面板日期改变Function

ShortcutType

参数名描述类型默认值
label选项的内容StringNumberFunction-
value选项值DateStringNumberArrayFunction-
format解析值所使用的格式,参考字符串解析格式String-

字符串解析格式

格式输出描述
YY21两位数的年份
YYYY2021四位数年份
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-12小时, 12 小时制, 两位数
m0-59分钟
mm00-59分钟,两位数
s0-59
ss00-59秒,两位数
S0-9数百毫秒,一位数
SS00-99几十毫秒,两位数
SSS000-999毫秒,三位数字
Z-5:00UTC 的偏移量
ZZ-0500UTC 的偏移量,数字前面加上 0
AAM PM-
aam pm-
Do1st... 3st带序号的月份中的某天
X1410715640.579Unix 时间戳
x1410715640579Unix 毫秒时间戳