DatePickerPane 日期选择器面板 beta ​

DatePickerPanel是DatePicker的核心组件。

选择某一天 ​

以”日“为基本单位,基础的日期选择控件

2026 September
SunMonTueWedThuFriSat
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
7
8
9
10

边框 ​

默认情况下,边框是默认的,如果你不想要边框请参考示例。例如,DatePicker不继承border。

No border:
2026 September
SunMonTueWedThuFriSat
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
7
8
9
10
2026 September
SunMonTueWedThuFriSat
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
7
8
9
10

禁用 ​

"禁用"属性决定日期选择器是否完全禁用。

Disabled
2026 September
SunMonTueWedThuFriSat
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
7
8
9
10

展示类型 ​

时间面板的类型由 type 属性指定。

Type:
2026 September
SunMonTueWedThuFriSat
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
7
8
9
10

本地化 ​

由于 Element Plus 的默认语言为英语,如果你需要设置其它的语言,请参考国际化文档。

要注意的是:日期相关的文字(月份,每一周的第一天等等)也都进行了本地化配置。

应用开发接口(API) ​

属性 ​

属性名说明类型默认值
model-value / v-model绑定值,如果是 range 选择器,数组长度应为 2number / string / Date / array''
border日期选择器是否有边框booleantrue
disabled禁用booleanfalse
clearable是否显示清除按钮booleantrue
editable 2.13.0文本框可输入booleantrue
typetype of the picker. quarter, quarters, and quarterrange are supported since 2.14.5enumdate
default-value可选,选择器打开时默认显示的时间object—
default-time范围选择时选中日期所使用的当日内具体时刻object—
value-format可选,绑定值的格式。不指定则绑定值为 Date 对象string—
date-format可选,输入框内部面板中显示的日期格式string see date formatsYYYY-MM-DD
time-format可选,输入框内部面板中显示的时间格式string see date formatsHH:mm:ss
unlink-panels在范围选择器里取消两个日期面板之间的联动booleanfalse
single-panel 2.14.0在范围选择器中只显示一个面板booleanfalse
disabled-date一个用来判断该日期是否被禁用的函数,接受一个 Date 对象作为参数。应该返回一个 Boolean 值。Function—
shortcuts设置快捷选项,需要传入数组对象array[]
cell-class-name设置自定义类名Function—
show-footerwhether to show footer where the date picker is one enumbooleanfalse
show-confirm是否显示确定按钮booleanfalse
show-week-number显示周数(除周外)booleanfalse

Events ​

名称详情类型
calendar-change在日历所选日期更改时触发仅限“range”类型。Function
panel-change当日期面板改变时触发。Function
clear 2.13.1当点击清除按钮时触发Function

插槽 ​

名称详情
default自定义单元格内容
prev-month上个月的图标
next-month下个月的图标
prev-year上一年图标
next-year下一年图标

源代码 ​

组件 • 样式 • 文档

贡献者 ​