日历

显示日期。

基础

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

2026 April
SunMonTueWedThuFriSat
29
30
31
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

控制器类型 2.13.1

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

2026 April
SunMonTueWedThuFriSat
29
30
31
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

自定义内容

通过将 scoped-slot 设置为 date-cell 来自定义日历单元格中显示的内容。在scoped-slot中可以获取日期(当前单元格的日期)、数据(包括type、isSelected、day属性)。详细信息请参考下面的API文档。

2026 April
SunMonTueWedThuFriSat

03-29

03-30

03-31

04-01

04-02

04-03

04-04

04-05

04-06

04-07

04-08

04-09

04-10

04-11

04-12

04-13

04-14

04-15

04-16

04-17

04-18

04-19

04-20

04-21

04-22

04-23

04-24

04-25

04-26

04-27

04-28

04-29

04-30

05-01

05-02

范围

设置 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 April
SunMonTueWedThuFriSat
29
30
31
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

本地化

默认语言环境为英语,如果需要使用其他语言,请查看国际化

请注意,日期时间区域设置(月份名称、一周的第一天...)也在本地化中配置。

API

属性

名称描述类型默认
模型值 / v 模型绑定值日期
范围时间范围,包括开始时间和结束时间。开始时间必须是一周的开始日期,结束时间必须是一周的结束日期,时间跨度不能超过两个月。数组
控制器类型 2.13.1日历标题控制器的类型枚举按钮
格式化程序 2.13.1controller-type 为“选择”时格式化标签功能

老虎机

名称描述类型
日期单元格type 表示日期所属月份,可选值为上月、当月、下月; isSelected表示是否选择日期; day 是格式为 YYYY-MM-DD 的格式化日期; date 是单元格代表的日期对象
标题日历标题的内容对象

暴露

|名称 |描述 |类型 | | ------------------------ | | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | |选定日期 |当前选择的日期 | 对象 | |挑选日 |选择特定日期 | 功能 | |选择日期 |选择日期 | 功能 | |计算验证日期范围 |根据开始和结束日期计算有效日期范围 | 功能 |

类型声明

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