Calendar 日历
显示日期
基础用法
设置 value 来指定当前显示的月份。如果 value 未指定,则显示当月。 value 支持 v-model 双向绑定。
2026 October
| Sun | Mon | Tue | Wed | Thu | Fri | Sat |
|---|---|---|---|---|---|---|
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
| Sun | Mon | Tue | Wed | Thu | Fri | Sat |
|---|---|---|---|---|---|---|
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
| Sun | Mon | Tue | Wed | Thu | Fri | Sat |
|---|---|---|---|---|---|---|
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
| Sun | Mon | Tue | Wed | Thu | Fri | Sat |
|---|---|---|---|---|---|---|
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
| Sun | Mon | Tue | Wed | Thu | Fri | Sat |
|---|---|---|---|---|---|---|
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 | 日历头部控制器类型 | enum | button |
| formatter | controller-type 为 select 时格式化选项标签 | Function | — |
| render-date-cell | 自定义日期单元格 | Function | — |
| render-header | 自定义头部 | Function | — |
Calendar Date Cell Data
| 属性名 | 说明 | 类型 |
|---|---|---|
| type | 日期所属月份 | enum |
| isSelected | 是否为当前选中日期 | boolean |
| day | YYYY-MM-DD 格式日期 | string |
| date | 单元格对应日期 | Date |
Calendar Exposes
| 名称 | 说明 | 类型 |
|---|---|---|
| selectedDay | 当前选中日期 | Date / undefined |
| pickDay | 选择指定日期 | Function |
| selectDate | 切换到指定相对日期 | Function |
| calculateValidatedDateRange | 根据开始与结束日期计算有效区间 | Function |