变更记录

1 简介

1.1功能介绍

日期控件用于报表的筛选条件面板，供报表查看者选择日期使用。日期控件可以设置不同的时间粒度，包括年、年季、年月、年月日，不同粒度的日期控件具有不同的交互方式（详见“1.2应用场景”小节）。当日期控件的粒度为年/年季/年月时，将日期控件对应的参数与查询SQL配合使用，可以实现使用日期范围对数据进行筛选。

1.2应用场景

• 选择年月日

• 选择年月

• 选择年季

• 选择年

• 选择日期时间

1.3系统路径

【数据服务云】→【轻报表】

2 主要操作

日期控件与日期时间控件的设置步骤一样，区别是日期控件可以选择时间粒度，日期时间控件不能选择时间粒度，下面以日期控件为例介绍使用方法。

2.1定义日期控件

步骤1：进入轻报表，打开数据集设计器，选择“参数”页签。

步骤2：在“参数”页签的右上角点击插入一条参数，控件类型选择“日期控件”。

步骤3：点击参数的“详细设置”按钮，打开日期控件的详细设置面板。

步骤4：设置日期控件的时间粒度和默认值。

（1）时间粒度：

• 年月日：若时间粒度设置为“年月日”，则报表的筛选条件面板内，该控件为“年月日选择器”，报表查看者可以选择年月日。“年月日选择器”如下图所示：

• 年月：若时间粒度设置为“年月”，则报表的筛选条件面板内，该控件为“年月选择器”，报表查看者可以选择年月。“年月选择器”如下图所示：

• 年季：若时间粒度设置为“年季”，则报表的筛选条件面板内，该控件为“年季选择器”，报表查看者可以选择年季。“年季选择器”如下图所示：

• 年：若时间粒度设置为“年”，则报表的筛选条件面板内，该控件为“年选择器”，报表查看者可以选择年。“年选择器”如下图所示：

（2）默认值：默认值指进入报表时，筛选条件面板内，参数控件默认选择的值。支持设置为固定日期、相对于服务端的日期、表达式定义。

• 固定日期：选择一个固定日期作为默认值。

• 相对于服务端的日期：以服务端的日期为基准，设置相对日期。

设置举例1：时间粒度为“年月日”时，默认值按“相对于服务端的日期”进行设置，设置为“前0日”，即默认值为当天。

设置举例2：时间粒度为“年月日”时，默认值按“相对于服务端的日期”进行设置，设置为“前1月的第一天”，即默认值为上个月的第一天。

Tips：当时间粒度为“年月日”时，默认值需要设置一个完整的年月日日期，所以当偏移范围为月/季/年时，需要指定默认值是偏移后的那个月/季/年中的第一天还是最后一天。

设置举例3：时间粒度为“年月”时，默认值按“相对于服务端的日期”进行设置，设置为“前1月”，即默认值为上个月。

• 表达式定义：使用日期表达式进行定义。

2.2使用日期参数

在查询语句中使用参数，语法为：@参数名。

Tips：当日期粒度为年/年季/年月时，使用'@参数名' 实际取到的是年/年月/年季的最后一天（即完整的年月日信息）。若需要使用此粒度的控件对数据根据日期范围进行筛选，则相当于'@参数名' 取到的是日期范围中的最后一天，用户可在查询语句中进一步对'@参数名' 提取出相应的“年”值或“年月”值，再拼接需要的“日”值，即可获得需要的开始日期。以MySQL为例，如下图所示，在报表筛选条件面板选择“2021-06”后，该查询语句可以筛选出订单日期在2021-06-01~2021-06-30之间的数据。