日期由两个元素组成:日期和时间。当使用日期字段类型配置过滤条件时,通常可以创建两种类型的条件:固定日期和相对日期。
注:
当为过滤器指定含时间部分的日期值时,请按当地时区输入时间部分。时间部分将在应用过滤器之前于幕后转换为协调世界时间 (UTC)。应用过滤器后,结果将在以仪表盘元素的形式显示之前,从 UTC 转换回当地时区,具体取决于您的 web 浏览器设置。
此外,要按日期过滤要素,图层必须支持标准化 SQL 函数。
固定日期条件
固定日期过滤条件包括特定日期值。输入该值的方法包括:从值选项卡上的日期选取器中选择一个日期,或在字段选项卡上选择另一个日期字段。选择日期字段的工作方式与输入特定日期值相同,可基于字段的数据更改进行更新。
注:
仅在元素的图层具有多个日期字段时才会显示字段选项卡。
固定日期过滤条件仅可使用以下运算符创建:
- 等于
- 不等于
- 早于
- 等于或早于
- 晚于
- 等于或晚于
注:
通过创建具有固定日期的单个过滤器并使用逻辑运算符进行组合,可以创建具有一系列固定日期的固定日期过滤条件。
相对日期条件
相对日期过滤条件包括一系列日期值。范围可以限定到或包括当前时刻(即现在),或者可以是预定义时间段(例如,上周)。您可以输入的范围或限定类型取决于您选取的运算符。
运算符 | 限定类型 |
---|---|
在过去 | 现在 |
早于过去 | 现在 |
在未来 | 现在 |
晚于未来 | 现在 |
等于 | 预定义 |
不等于 | 预定义 |
早于 | 预定义 |
等于或早于 | 预定义 |
晚于 | 预定义 |
等于或晚于 | 预定义 |
限定到现在
使用限定到现在的日期范围的好处在于,该范围允许元素以数据可能的变化速率进行刷新。例如,配置为显示最近 30 分钟内数据的指示器可能每分钟显示不同的数据,如果其图层的刷新频率同样如此频繁。但是,显示昨天数据的指示器仅在今天日期变化后(即午夜之后)才会显示不同数据,与图层的刷新间隔无关。
选择与限定类型“现在”关联的运算符时,系统会提示您指定单位乘数 (N) 以及时间单位(例如,天、小时、分钟或秒)。例如,如果日期范围为 7 天,单位乘数为 7,则时间单位为天。
下表对这些时间单位进行了说明。请注意,所有日期值均以您的当地时区为准。
运算符 | 时间单位 | 说明 |
---|---|---|
在过去 | 秒 | 到当前这一秒为止的 N 秒之前。也就是说,范围包括截至当前时间的这一秒。 |
分钟 | 到当前这一分钟为止的 N 分钟之前。也就是说,范围包括截至当前时间的这一分钟。 | |
小时 | 到当前这一小时为止的 N 小时之前。也就是说,范围包括截至当前时间的这一小时。 | |
天数 | 从凌晨 12:00:00 开始, 到当前这一天为止的 N 天之前。也就是说,范围包括截至当前时间的今天。 | |
早于过去 | 秒 | 从凌晨 12:00:00 开始, 当前这一秒之前的 N 秒并继续向前。 |
分钟 | 从凌晨 12:00:00 开始, 当前这一分钟之前的 N 分钟并继续向前。 | |
小时 | 从凌晨 12:00:00 开始, 当前这一小时之前的 N 小时并继续向前。 | |
天数 | 从凌晨 12:00:00 开始, 当前这一天之前的 N 天并继续向前。 | |
在未来 | 秒 | 从现在开始的之后 N 秒。也就是说,范围包括当前时间之后的那一秒。 |
分钟 | 从现在开始的之后 N 分钟。也就是说,范围包括当前时间之后的那一分钟。 | |
小时 | 从现在开始的之后 N 小时。也就是说,范围包括当前时间之后的那一小时。 | |
天数 | 从现在开始,一直持续到下午 11:59:59。从现在开始的 N 天。也就是说,范围包括当前时间之后的今天。 | |
晚于未来 | 秒 | 从凌晨 12:00:00 开始, 当前这一秒之后的 N 秒并继续向后。 |
分钟 | 从凌晨 12:00:00 开始, 当前这一分钟之后的 N 分钟并继续向后。 | |
小时 | 从凌晨 12:00:00 开始, 当前这一小时之后的 N 小时并继续向后。 | |
天数 | 从凌晨 12:00:00 开始, 当前这一天之后的 N 天并继续向后。 |
限定到预定义时间段
当您不需要像图层的刷新频率一样频繁地更新数据时,即当您希望使用限定到现在的日期范围时,适合使用限定到预定义时间段的日期范围。
选择与预定义限定类型关联的运算符时,需要在时间段选项卡上指定一个间隔。
这些时间段基于以下单位。请注意,开始和结束时间始终基于您的当地时区。
- 天 - 一天从凌晨 12:00:00 开始,经过 24 小时,到下午 11:59:59 结束。对于军事时间,一天从 00:00:00 开始,经过 24 小时,到 23:59:59 结束。
- 周 - 一周从星期日凌晨 12:00:00 开始,连续经过 7 天,到第七天(即星期六)的下午 11:59:59 结束。
- 月 - 根据公历定义一个月。每个月从本月第一天的凌晨 12:00:00(当地时间)开始, 并一直持续到本月最后一天的下午 11:59:59 (当地时间)。
- 季度 - 每年按季度划分,一季为三个月,如下所述。
- 第一季度 - 一月至三月
- 第二季度 - 四月至六月
- 第三季度 - 七月到九月
- 第四季度 - 十月到十二月
- 年 - 一年有 12 个月,从 1 月 1 日的凌晨 12:00:00 开始,到 12 月 31 日的下午 11:59:59 结束。
预定义时间段 | 说明 |
---|---|
现在 | 当前日期和时间。 |
今天 | 从当前这一天的凌晨 12:00:00 开始,经过 24 小时。 |
昨天 | 从前一天凌晨 12:00:00 开始,经过 24 小时。 |
明天 | 从后一天凌晨 12:00:00 开始,经过 24 小时。 |
本周 | 从当前这一周的第一天凌晨 12:00:00 开始,经过 7 天。 |
上周 | 在本周开始之前才结束的 7 天时间。上周从本周之前一周的第一天凌晨 12:00:00 开始,经过 7 天。 |
下周 | 在本周结束之后才开始的 7 天时间。下周从本周之后一周的第一天凌晨 12:00:00 开始,经过 7 天。 |
本月 | 从当前这一月的第一天凌晨 12:00:00 开始,一直持续到该月最后一天的下午 11:59:59 结束。 |
上个月 | 从本月之前一月的第一天凌晨 12:00:00 开始,一直持续到当月最后一天的下午 11:59:59 结束。 |
下个月 | 从本月之后一月的第一天凌晨 12:00:00 开始,一直持续到当月最后一天的下午 11:59:59 结束。 |
本季度 | 从当前这一季度的第一天凌晨 12:00:00 开始,经过三个月,到该季度最后一天的下午 11:59:59 结束。 |
上个季度 | 从本季度之前一季度的第一天凌晨 12:00:00 开始,经过三个月,到该季度最后一天的下午 11:59:59 结束。 |
下个季度 | 从本季度之后一季度的第一天凌晨 12:00:00 开始,经过三个月,到该季度最后一天的下午 11:59:59 结束。 |
今年 | 从当前这一年的 1 月 1 日凌晨 12:00:00 开始, 持续 12 个月(截至 12 月 31 日下午 11:59:59)。 |
去年 | 从紧接今年的前一年的 1 月 1 日凌晨 12:00:00 开始, 持续 12 个月(截至 12 月 31 日下午 11:59:59)。 |
下一年 | 从紧接今年的后一年的 1 月 1 日凌晨 12:00:00 开始, 持续 12 个月(截至 12 月 31 日下午 11:59:59)。 |
年初至今 | 从当前这一年的 1 月 1 日凌晨 12:00:00 开始, 直到现在。该时间段与“今年”不同,因为后者可以包括未来日期,而“年初至今”不可以。 |