日期控件
功能概述
日期控件是Quick BI仪表板中用于支持用户通过输入或选择日期类型的字段值，动态筛选和查询不同日期（或日期范围）对应数据的核心工具。它使得仪表板的查看者能够与基于时间的数据进行深度交互，根据特定的日期条件过滤图表和表格，从而聚焦于特定时间段内的业务表现、趋势变化或事件发生情况。日期控件主要服务于对仪表板中已存在的日期类型字段进行查询和筛选。
主要优势:
时间维度数据筛选: 允许用户根据自定义的日期或日期范围，精确地筛选仪表板上的数据。
灵活的日期选择方式: 支持单点日期选择、日期区间选择，以及预设的快捷区间（如昨日、近7天、本月等）。
时间粒度控制: 对于包含年月日时分秒的详细日期字段，支持在控件层面或同步到图表层面切换不同的时间聚合粒度（如年、月、日、时、分、秒），方便从不同时间视角分析数据。
提升分析效率: 通过快速定位到特定的时间段，减少了用户在大量时间序列数据中寻找信息的时间。
交互式数据探索: 结合默认值设定、动态函数、日期前后快捷切换等功能，增强了用户与时间数据的交互体验。
前提条件
1.在配置日期控件前，请确保您已创建好仪表板，并且仪表板中的图表包含您希望用于查询的日期字段。且配置查询条件时，您需要为查询控件命名，选择要关联的图表及图表中对应的日期字段
基础配置
配置项 | 说明 | 示例 |
展示类型 | 日期查询控件支持日期选择。 | |
时间粒度 |
| |
数据来源 | 查询控件的数据来源支持默认日期选框和数据集字段，当数据来源选择默认日期选框时，支持日期级联；当数据来源选择数据集字段时，支持同源级联、非同源级联和日期级联。具体请参见日期查询控件级联配置。 |
不存在任何数据来源，仅支持日期级联，不支持和其他控件进行级联
选择数据集作为数据来源，除支持日期级联外，还支持和下拉、树形控件进行级联。
|
设定时间筛选范围 | 通过设定查询的时间范围来控制数据筛选量。设定时间筛选范围后，超出的时间范围无法选择。
说明 T的粒度选择支持下拉选择当前时间粒度包含的所有粒度，如当前时间粒度为年-月-日，则可以下拉切换选择年、月、日这三个粒度；如当前时间粒度为年-月-日-时-分-秒，则可以选择T的粒度为年、月、日、时、分、秒。 适用场景例如当时间粒度为年月日时分秒时，切换秒的相对时间，如果时间粒度只有秒，那么计算需要多少秒比较麻烦，此时可以切换到日粒度，快速查看不同日期下的时间数据。
|
|
筛选方式 | ||
设置默认值 | 您可以通过手动设定或动态函数的方式，设置默认值。
| 支持仅设置开始于或结束于，当开始时间和结束时间都设置的时候，开始时间不能大于结束时间。
|
开启日期前后快捷切换 | 开启后，会在报表页面的日期筛选框新增一个快捷切换。 说明： 快捷箭头必须在日期控件框内有具体日期时才可以操作。 如果已设置时间筛选范围，则通过左右箭头快速切换日期时，不能超出设置的日期筛选范围 | 日期的时间粒度为年、季、月、周、日且筛选方式为单粒度的日期时，支持配合该参数。 当筛选方式选择为单日，且开启日期前后快捷切换功能，则仪表板中对应的日期控件处会新增一个快捷箭头，单击可以快速切换日期，效果图如下。
|
单日期查询
使用场景
单日期查询允许用户选择一个特定的日期点（如某一天、某一月、某一年），仪表板将显示该日期点对应的数据。例如：
查看特定某天的销售额、用户活跃数。
分析某个特定月份的财务报告。
回顾某一年的重要事件或业绩。
操作步骤
以订单日期（day）为例，为您展示某天的销售数据。
在仪表板管理页面，选择已创建好的仪表板，该仪表板包含以下图表和查询控件。
在查询控件上单击高级配置。
在查询条件设置页面，按照下图指引，设置查询条件。
配置完成后，在查询条件中选择日期，并单击查询，查看某日的销售情况。
日期区间查询
使用场景：
日期区间查询允许用户选择一个开始日期和一个结束日期，仪表板将显示这个时间段内的数据。例如：
分析某一周、某一月、某一季度或任意自定义时间段内的销售趋势。
比较不同时间段的业绩表现。
查看一段时间内的用户行为日志。
操作步骤：
以订单日期（day）为例，为您展示某一段时间内的某门店的盈利情况。
在仪表板管理页面，选择已创建好的仪表板，该仪表板包含以下图表和查询控件。
仪表板图表中需要包含日期字段。
单击添加常规控件。
在查询条件设置页面，按照下图指引，设置查询条件。
配置完成后，在查询条件中选择日期，并单击查询，查看某一段时间内的某门店的盈利情况。
筛选方式为区间时，您还可以使用以下功能，方便您更好地查看数据。
区间类型：支持开始于、结束于、时间区间和快捷区间这四种类型。
开始于
结束于
时间区间
快捷区间
定制快捷区间：支持多种区间场景，方便您定制化设置快捷区间的值。
说明
仅当区间类型为快捷区间时，支持配置该选项。
支持配置基于昨日的快捷区间，具体请参见查询类型配置展示。
设定仅起止时间关联的图表：在仪表板中，您可以设定仅起止时间关联的图表，让同一个日期区间对不同的图表生效。
支持三种时间范围的筛选：
限定开始时间
限定结束时间
限定时间区间
说明
仅当区间类型为时间区间时，支持配置该选项。
快速配置日期粒度切换
使用场景：
当关联的日期字段包含详细的年月日时分秒信息时（例如，订单日期(ymdhms)），日期控件支持在不同的时间粒度（如年、月、日、时、分、秒）之间进行切换，从而让用户可以在同一个图表或仪表板上快速地从不同时间视角审视数据。例如：
在查看年度销售总览时，快速下钻到某个月份的明细，或某个特定日期的每小时销售情况。
对于实时监控类报表，方便地在秒级、分钟级、小时级数据之间切换。
配置方式：
支持将日期查询控件配置为日期粒度切换仅控制日期控件或同步控制图表，两者区别如下：
配置方式 | 说明 | 示例 |
日期粒度切换仅控制日期控件 | 日期查询控件中的日期粒度切换仅对日期控件的筛选项生效，并不会改变图表的展示日期粒度。 该方式适用于仅需切换日期查询控件的时间筛选项，无需更改图表展示的时间维度的场景。具体配置说明请参见日期粒度切换仅控制日期控件。 | 当前图表展示日期粒度为年，在查询控件中选择查询日期粒度为月，并选定月区间为2023年1月-9月，点击查询后，图表的展示日期粒度仍为年，且仅以年维度展示2023年1月-9月内的总体数据。具体效果如图所示。 |
日期粒度切换同步控制图表 | 在图表的字段面板中配置了日期维度组的前提下，通过同步控制的模式，图表的展示日期粒度可以自动跟随日期查询控件中的日期粒度切换。 该方式适用于需要通过日期查询控件灵活切换图表展示的时间维度，以查看不同时间维度下的具体数据表现的场景。具体配置说明请参见日期粒度切换同步控制图表。 | 当前图表展示日期粒度为年，在查询控件中选择查询日期粒度为月，并选定月区间为2023年1月-11月，点击查询后，图表内的展示日期粒度即同步切换为月，且展示了2023年1月-11月的每月明细。具体效果如图所示。 |
日期粒度切换仅控制日期控件
日期查询控件中的日期粒度值，将仅对日期控件的筛选项生效。您可以根据以下说明进行配置。
在查询条件设置页面，按照下图指引，设置查询条件。
本例中，日期字段选择订单日期（ymdhms）。
其中，在基础配置区域，参数配置说明如下：
时间粒度：关联字段选择时间粒度字段后，时间粒度中会自动填充一个默认值。
当关联字段为订单日期（ymdhms）时，除了默认值年-月-日-时-分-秒外，还支持添加年、年-季度、年-月、年-周、年-月-日，您可以根据对时间粒度的需要，在时间粒度下拉框中选择或删除不同时间粒度。
分粒度设置：设置分粒度后，您可以快速在一个仪表板页面中查看不同时间视角的数据信息。
说明
仅当时间粒度选择两个及以上的值时，才需要支持配置分粒度。
设定默认筛选值：为查询控件设置默认值。
分粒度设置后，您也可以为每个时间粒度单独设置不同的默认值，方便您在切换时间粒度时，快速查询数据信息。
配置完成后，在查询条件中切换粒度，选择日期并单击查询。
您也可以切换分粒度，快速查询数据。
说明
当数据集配置了财年时，查询控件的财年开始于跟随数据集中的字段配置，不支持修改。财年的配置请参见创建并管理数据集。
日期粒度切换同步控制图表
在图表字段面板中配置了日期维度组的前提下，您可以为当前查询控件设置在切换时间粒度时，同步控制图表中展示的时间维度。具体操作步骤如下。
为需要被同步控制时间粒度的图表，配置日期维度组。
在图表的数据面板中，点击
图标，选择下拉列表下的新建维度组。
在新建维度组字段弹窗中按需配置日期字段，完成后点击确定。
将创建好的日期维度组字段拖入图表字段面板中，点击更新。
添加查询控件，并在查询条件设置页面，设置查询条件。
配置内容 | 配置说明 | |
区域 ① | 查询控件名称 | 填写自定义查询控件名称，您可以根据查询控件的作用命名，例如：日期筛选。 |
区域 ② | 图表及关联字段 | 选择查询控件需要同步控制日期粒度的图表，及需要关联的年月日分秒字段。 说明
|
区域 ③ | 基础配置 | 您需要在此处选中时间粒度切换同步控制图表维度选项，以确保查询控件中的日期粒度值能同步生效至关联图表中。其余参数配置同日期粒度切换仅控制日期控件中的操作。 说明
|
配置完成后，在查询控件中选择时间粒度、设定日期区间并单击查询，关联图表展示的时间粒度将被同步切换。
说明
当数据集配置了财年时，查询控件的财年开始于跟随数据集中的字段配置，不支持修改。财年的配置请参见创建并管理数据集。