日期选择面板 beta

DatePickerPanelDatePicker 的核心面板组件。

选择某日

以「日」为粒度的基础用法。

2026 May
SunMonTueWedThuFriSat
26
27
28
29
30
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

边框

默认带边框;嵌入 DatePicker 等场景下可不继承边框。

No border:
2026 May
SunMonTueWedThuFriSat
26
27
28
29
30
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
2026 May
SunMonTueWedThuFriSat
26
27
28
29
30
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

禁用

disabledtrue 时整体禁用。

Disabled
2026 May
SunMonTueWedThuFriSat
26
27
28
29
30
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

类型

展示粒度由 type 决定。

Type:
2026 May
SunMonTueWedThuFriSat
26
27
28
29
30
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

国际化

默认语言为英文;若需其他语言请参考国际化

日期时间区域设置(月份名、每周起始日等)由语言包配置。

API

属性

名称说明类型默认值
model-value / v-model绑定值;范围选择时为长度 2 的数组number / string / Date / array''
border是否显示边框booleantrue
disabled是否禁用booleanfalse
clearable是否显示清空按钮booleantrue
editable输入是否可编辑booleantrue
type选择器类型enumdate
default-value可选,日历默认定位的日期object
default-time可选,范围选择时默认时间object
value-format可选,绑定值格式;未指定时为 Datestring
date-format可选,面板内日期展示格式stringday.js 格式YYYY-MM-DD
time-format可选,面板内时间展示格式stringday.js 格式HH:mm:ss
unlink-panels范围选择时是否解除左右面板联动booleanfalse
disabled-date判断某日是否禁用的函数Function
shortcuts快捷选项数组array[]
cell-class-name单元格自定义类名Function
show-footer是否在底部显示操作区;当类型为 enum 之一时生效booleanfalse
show-confirm是否显示确认按钮booleanfalse
show-week-number是否显示周数booleanfalse

事件

名称说明类型
calendar-change日历所选日期变化,仅 range 模式Function
panel-change点击导航切换年月时触发Function
clear点击清空时触发Function

插槽

名称说明
default自定义单元格
prev-month上一月图标
next-month下一月图标
prev-year上一年图标
next-year下一年图标