DatePickerPane 日期选择器面板 beta

DatePickerPanelDatePicker的核心组件。

选择某一天

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

2025 September
SunMonTueWedThuFriSat
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

边框

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

No border:
2025 September
SunMonTueWedThuFriSat
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
2025 September
SunMonTueWedThuFriSat
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

禁用

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

Disabled
2025 September
SunMonTueWedThuFriSat
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

展示类型

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

Type:
2025 September
SunMonTueWedThuFriSat
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

本地化

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

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

应用开发接口(API)

属性

属性名说明类型默认值
model-value / v-model绑定值,如果它是数组,长度应该是 2number / string / object''
border日期选择器是否有边框booleantrue
disabled禁用booleanfalse
clearable是否显示清除按钮booleantrue
type选择器类型,默认是普通选择器enumdate
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
disabled-date一个用来判断该日期是否被禁用的函数,接受一个 Date 对象作为参数。 应该返回一个 Boolean 值。Function
shortcuts设置快捷选项,需要传入数组对象object[]
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

插槽

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

源代码

组件样式文档

贡献者