Calendar 日历

显示日期

基础用法

设置 value 来指定当前显示的月份。如果 value 未指定,则显示当月。 value 支持 v-model 双向绑定。

2026 October
SunMonTueWedThuFriSat
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

控制器类型 2.13.1

您可以设置日历头部的控制器类型。设置 select时,您可以使用 formatter 自定义 label。

2026 October
2026
10
SunMonTueWedThuFriSat
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

自定义内容

通过设置名为 date-cell 的 scoped-slot 来自定义日历单元格中显示的内容。在 scoped-slot 可以获取到 date(当前单元格的日期), data(包括 type,isSelected,day 属性)。详情解释参考下方的 API 文档。

2026 October
SunMonTueWedThuFriSat

09-27

09-28

09-29

09-30

10-01

10-02

10-03

10-04

10-05

10-06

10-07

10-08

10-09

10-10

10-11

10-12

10-13

10-14

10-15

10-16

10-17

10-18

10-19

10-20

10-21

10-22

10-23

10-24

10-25

10-26

10-27

10-28

10-29

10-30

10-31

范围

设置 range 属性指定日历的显示范围。开始时间必须是周起始日,结束时间必须是周结束日,且时间跨度不能超过两个月。

2019 March
SunMonTueWedThuFriSat
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

自定义日历头部

Custom header content2026 October
SunMonTueWedThuFriSat
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

国际化

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

要注意的是:日期相关的文字(月份,每一周的第一天等等)也都是通过国际化来配置的。

Calendar API

Calendar Attributes

属性名说明类型默认值
value绑定值Date—
onChange选中日期变化Function—
range时间范围,开始日期必须为周起始日,结束日期必须为周结束日,跨度不能超过两个月array—
controller-type日历头部控制器类型enumbutton
formattercontroller-type 为 select 时格式化选项标签Function—
render-date-cell自定义日期单元格Function—
render-header自定义头部Function—

Calendar Date Cell Data

属性名说明类型
type日期所属月份enum
isSelected是否为当前选中日期boolean
dayYYYY-MM-DD 格式日期string
date单元格对应日期Date

Calendar Exposes

名称说明类型
selectedDay当前选中日期Date / undefined
pickDay选择指定日期Function
selectDate切换到指定相对日期Function
calculateValidatedDateRange根据开始与结束日期计算有效区间Function