Calendar 日历 ​

展示日期。

基础用法 ​

使用 value 指定当前展示的月份;未设置则展示当月。value 支持双向绑定。

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

控制器类型 ​

可设置日历头部的控制器类型;为 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 的作用域插槽自定义单元格展示。插槽作用域中可获取 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

国际化 ​

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

日期时间相关文案(月份名、每周起始日等)也在本地化配置中设置。

日历 API ​

日历 属性 ​

名称说明类型默认值
model-value / v-model绑定值Date—
range时间范围(起止);开始须为一周起始日,结束须为一周结束日,跨度不超过两个月array—
controller-type日历头部控制器类型enumbutton
formattercontroller-type 为 select 时格式化标签Function—

日历 插槽 ​

名称说明
date-cell自定义日期单元格。作用域参数包含 date 与 data:其中 data.type 表示日期所属月份(prev-month、current-month、next-month);data.isSelected 为是否选中;data.day 为 YYYY-MM-DD 字符串;data.date 为 Date 对象。
header日历头部内容;作用域参数包含字符串 date。

日历 暴露 ​

名称说明类型
selectedDay当前选中日期object
pickDay选中指定日期Function
selectDate按类型切换日期Function
calculateValidatedDateRange根据起止日期计算合法范围Function

类型声明 ​

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