1. 概述
1.1 版本
FineBI 版本 | 功能变动 |
---|---|
5.1 | - |
5.1.10 | 支持时间过滤组件「设为必填项」和「设置可选区间」 |
1.2 应用场景
时间过滤组件可以对其他组件的日期字段进行过滤,例如过滤出年月、季度以及某个日期区间等。
在制作过滤组件时,因为组件涉及的基础数据时间跨度太大,担心查看用户选择太大的范围导致宕机,并且有些日期的查询没有意义,此时能够使用「设置可选区间」功能,通过时间过滤组件限制用户选择时间范围。
用户可以设置过滤值为相对于当前时间的动态时间,可以随着日期变化而变化。
1.3 功能介绍
时间过滤组件只能对日期类型的字段进行过滤。
时间过滤组件一共有七种,包括「年份过滤组件」、「年月过滤组件」、「年季度过滤组件」、「日期过滤组件」、「日期面板过滤组件」、「日期区间过滤组件」、「年月区间过滤组件」,如下图所示:
2. 示例
使用「年份过滤组件」,用内置数据集「地区数据分析」为示例。
例如使用年份过滤组件过滤数据,并且希望用户只能选择 2014 年和 2015 年的数据进行过滤。
2.1 创建年份过滤组件
1)创建组件并新建年份过滤组件,如下图所示:
2.2 设置可选区间
2)进入过滤组件的编辑界面,绑定字段「合同签约时间」,勾选「设置可选区间」为 2014-2015 ,如下图所示:
2.3 效果查看
可以看到默认状态下,过滤组件过滤出了 2014 年的数据,同时用户只能选择 2014 年和 2015 年的数据进行过滤,其他时间都灰化无法显示,如下图所示:
、
3. 时间过滤组件应用
拖入时间过滤组件并绑定「合同事实表」的「合同签约时间」字段
时间控件 | 设置的条件 | 效果 |
年月 | 选择2014年1月 | 展示「合同签约时间」为2014年1月到的数据 |
只选择“年份=2014” | 展示「合同签约时间」所有年份为2014年的数据 | |
只选择“月份=6” | 展示「合同签约时间」所有年份下“月份”为6月的数据 | |
年季度 | 选择2014年第二季度 | 展示「合同签约时间」2014-04到2014-06的数据 |
只选择“季度=第2季度” | 展示「合同签约时间」所有年份下“季度”为第2季度的数据 | |
日期 | 选择2014-10-30 | 展示「合同签约时间」为2014-10-30的数据 |
日期面板 | 选择2014-10-30 | 展示「合同签约时间」为2014-10-30的数据 |
日期区间 | 选择2015-09-01至2015-09-10 | 展示「合同签约时间」在2015-09-01至2015-09-10的数据 |
只选择“开始时间=2015-09-01” | 展示「合同签约时间」在2015-09-01之后的所有数据 | |
只选择“结束时间=2015-09-10” | 展示「合同签约时间」在2015-09-10之前的所有数据 | |
年月区间 | 选择2013-01至2013-07 | 展示「合同签约时间」在2013-01至2013-07的所有数据 |
只设置开始时间“年份=2013” | 展示「合同签约时间」在2013-01-01之后的所有数据 | |
只设置结束时间“年份=2013” | 展示「合同签约时间」在2013-12-31之前的所有数据 |
4. 默认过滤当前时间
过滤组件可以筛选当前时间,例如对「日期过滤组件」进行筛选时,可以选择当前时间「今天」,如下图所示:
日期过滤组件、日期面板过滤组件、日期区间过滤组件可以选择「今天」;
年份过滤组件可以选择「今年」;
年月过滤组件,年月区间过滤组件可以选择「本月」;
年季度过滤组件可以选择「本季度」。
注:如果需要动态的当前时间,则需要在动态时间中设置,参考本文第 5 章节。
5. 过滤动态时间
用户可以设置过滤值为相对于当前时间的动态时间,可以随着日期变化而变化。
5.1 示例
例如当前时间为 2020 年 9 月 14 日,需要筛选出上个月 14 号的数据,点击确定,如下图所示:
日期会动态变化,当前时间变为 2020-09-15,会自动过滤出 2020-08-15 的数据。
5.2 其他说明
5.2.1 不同过滤组件相对当前时间的可选项
过滤组件 | 相对当前时间可选项 |
---|---|
年份过滤组件 | 年 |
年季度过滤组件 | 年、季度 |
年月过滤组件/年月区间过滤组件 | 年、月 |
日期过滤组件/日期区间过滤组件/日期面板过滤组件 | 年、季度、月、周、天、工作日 |
5.2.2 工作日说明
日期过滤组件/日期区间过滤组件/日期面板过滤组件可以过滤出相对当前时间的某个工作日的数据。
FineBI 中默认将国家节假日去除后的日期作为了工作日。
企业可以修改%FineBI%\webapps\webroot\WEB-INF\assets\extdata下的「holiday」文件来匹配自身的节假日。
将「holiday」文件以 记事本 形式打开,增加或删减节假日,如下图所示:
若用户是 2022 年之前的 FineBI 版本,需要下载最新的工作日文件: holiday.zip
,解压后替换 %FineBI%\webapps\webroot\WEB-INF\assets\extdata 下原来的「holiday」文件。若为 2022 年之后的版本,则不需要处理。
注1:在进行节假日自定义时,目前仅支持 xxxx-xx-xx 日期格式,如上图所示,不支持 xxxx/xx/xx 格式。
注2:不要直接用 Excel 修改 holiday 文件,可以使用文本编辑器来修改 holiday 文件。若直接用 Excel 修改 holiday 文件,保存后自动为 xxxx/xx/xx 格式,会导致过滤出错。
6. 过滤时分秒
「日期」、「日期面板」和「日期区间」三个过滤组件在过滤组件设置界面可选择显示时间,默认不开启。开启后支持设置时、分、秒。
1)勾选「显示时间」即可开启,如下图所示:
2)开启显示时间后过滤组件显示如下图所示,可以对具体的时分秒进行过滤。