Calendar 日历 ​

显示日期

基础用法 ​

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

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

控制器类型 2.13.1 ​

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

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

自定义内容 ​

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

2026 November
SunMonTueWedThuFriSat

11-01

11-02

11-03

11-04

11-05

11-06 ✔️

11-07

11-08

11-09

11-10

11-11

11-12

11-13

11-14

11-15

11-16

11-17

11-18

11-19

11-20

11-21

11-22

11-23

11-24

11-25

11-26

11-27

11-28

11-29

11-30

12-01

12-02

12-03

12-04

12-05

范围 ​

设置 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 November
SunMonTueWedThuFriSat
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

国际化 ​

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

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

API ​

Attributes ​

属性名说明类型默认值
model-value / v-model选中项绑定值Date—
range时间范围,包括开始时间与结束时间。开始时间必须是周起始日,结束时间必须是周结束日,且时间跨度不能超过两个月。array—
controller-type 2.13.1日历头部的控制器类型enumbutton
formatter 2.13.1当 controller-type 为“select”时的格式标签Function—

Slots ​

插槽名说明类型
date-celltype 表示该日期的所属月份,可选值有 prev-month、current-month 和 next-month;isSelected 标明该日期是否被选中;day 是格式化的日期,格式为 yyyy-MM-dd;date 是单元格的日期object
header卡片标题内容object

Exposes ​

名称说明类型
selectedDay当前已选日期object
pickDay选择一个具体日期Function
selectDate选择日期Function
calculateValidatedDateRange根据开始与结束日期计算验证日期范围Function

类型声明 ​

显示类型声明
ts
type CalendarDateType =
  'prev-month' | 'next-month' | 'prev-year' | 'next-year' | 'today'

源代码 ​

组件 • 样式 • 文档

贡献者 ​