[]
        
在线Demo 免费试用
(Showing Draft Content)

日期范围

1.概述

1.1功能概述

日期范围筛选器与数值范围筛选器类似,不同之处在于日期范围筛选器绑定的是一个日期字段,根据日期进行筛选。

组件支持使用“年”、“年-季度”、“年-月”、“日期”和“日期时间”各种粒度的筛选。

2.添加筛选器

在左边筛选器中选择日期范围筛选器图标image2018-9-17_18-9-17.png,并将该筛选器拖拽至页面中。

image

3.数据绑定

将日期或日期时间字段拖拽至绑定区域。仅能绑定一个日期类型字段。

image

4.属性设置

为了更加符合实际应用场景,我们经常需要进行属性设置,使日期筛选器更符合需求。

image

本页主要介绍筛选器样式中的属性,其他属性请详见组件外观与属性

4.1日期模式

支持以下日期模式:

  • 年-季度

  • 年-月

  • 日期(默认)

image

type=info

注意:

日期模式将影响到默认值可选日期范围的设置,如:日期模式选择“”,在设置默认值时,在日历组件中仅能选择年份。

image

4.2显示模式

可选 日期 (默认)或者 日期范围

4.2.1日期

指定一个单一日期进行数据的筛选。

image

4.2.2日期范围

指定日期范围进行数据的过滤。

image

  • 仅输入开始日期,将过滤指定开始日期之后的所有数据。

  • 仅输入结束日期,将过滤指定结束日期之前的所有数据。

  • 输入开始日期和结束日期,将过滤指定日期范围之内的所有数据。

4.3默认值

为仪表板中的日期范围组件指定一个默认值,这样每次打开仪表板时都会首先按照默认设置进行显示。

支持 绝对日期相对日期 两种设置方法。

4.3.1绝对日期

点击日历组件,为该日期范围筛选器设置默认值。

image

4.3.2相对日期

当值类型为“相对日期”,在展开的对话框中可以进行相应的设置。

例如,当运行仪表板时,想默认筛选出本年的数据,将日期单位指定为“”,并选择“今年”即可。其他具体设定,请参考:相对日期

image

type=info

注意

无论是绝对日期还是相对日期,设置日期时的单位与设置的 日期模式 统一。

如下图所示,日期模式设置为“年-季度”,设置默认值时,无论是绝对日期还是相对日期,都是仅能设置年和季度。

image

4.3.3使用参数设置默认值

支持使用仪表板参数来设置日期范围筛选器的默认值,参数类型需要是日期或日期时间类型。有关仪表板参数的更多介绍,请见仪表板参数

image2022-4-19_16-54-22.png

type=info

提示

筛选器显示模式是日期和日期范围时,对于绑定参数的处理方式不同。

当显示模式为日期时,会对参数按照设定的日期模式进行处理。如绑定的参数值为2020.5.25,当前的日期模式设定的是“年”,那么这里只取参数的年份,即2020年,筛选数据为2020年一整年的数据。

当显示模式为日期范围时,不对参数进行处理。即使日期模式为“年”,而绑定的两个参数值为具体日期,那么也会按照实际的参数值进行筛选,不会处理成年份。

4.4数据格式

设置筛选器上显示的日期格式。

image

4.5日期提示文本

当输入框中未显示具体时间数据时,显示的提示文本。

image

4.6可选日期范围

用于指定可选日期的范围,无法选择超过设定的日期范围的日期,提供了两个选项供用户使用:数据绑定、自定义。

4.6.1数据绑定

获取绑定的日期字段的最大值及最小值来设定可选值的范围。

image

4.6.2自定义

通过设定具体的日期来限制可选的范围。

image

4.7允许清空日期

是否允许用户在使用筛选器时,清空筛选器中的日期设定。允许清空日期时,当鼠标悬浮至输入框右侧就会出现叉号,点击即可清空当前设定日期。

image

4.8允许切换日期模式

开启后,在预览时可切换日期模式,效果如下:

image

4.9允许切换显示模式

开启后,在预览时可切换显示模式,效果如下:

image

4.10内边框颜色/尺寸/内容字体

设置筛选器的内边框颜色、粗细以及筛选器的文字字体。

image