基于日期的过滤条件

日期由两个部分组成:日期和时间。 当使用日期字段类型配置过滤条件时,通常可以创建两种类型的条件:固定日期和相对日期。

注:

要按日期过滤要素,图层必须支持标准化 SQL 函数。

过滤日期时,请以本地时区输入时间组件。 在后台,仪表盘将搜索目标图层的属性以获取时区信息。 如果找到时区信息,将以该时区发送查询。 这可能涉及将输入值转换为目标图层的时区。 如果未找到时区信息,则仪表盘将在发送输入值之前将其转换为协调世界时间 (UTC)。

提示:

固定日期条件

固定日期过滤条件包括特定日期值。 输入该值的方法包括:从值选项卡上的日期选取器中选择一个日期,或在字段选项卡上选择另一个日期字段。 选择日期字段的工作方式与输入特定日期值相同,可基于字段的数据更改进行更新。

固定日期过滤器的输入值选项
注:

仅在元素的图层包括多个日期字段时才会显示字段选项卡。

固定日期过滤条件仅可使用以下运算符创建:

  • 为
  • 不等于
  • 早于
  • 等于或早于
  • 晚于
  • 等于或晚于

注:

还可通过创建具有固定日期的单个过滤器并使用逻辑运算符进行组合,以创建具有一系列固定日期的固定日期过滤条件。

相对日期条件

相对日期过滤条件包括一系列日期值。 范围可以限定到或包括当前时刻(现在),或者可以是预定义时间段(例如,上周)。 您可以输入的范围或限定类型取决于您选取的运算符。

运算符限定类型

在过去

当前时间

早于过去

当前时间

在未来

当前时间

晚于未来

当前时间

为

现在或预定义

不等于

现在或预定义

早于

现在或预定义

等于或早于

预定义

晚于

现在或预定义

等于或晚于

预定义

限定到现在

使用限定到现在的日期范围的好处在于,该范围允许元素以数据可能的变化速率进行刷新。 例如,配置为显示最近 30 分钟内数据的指示器可能每分钟显示不同的数据,如果其图层的刷新频率同样如此频繁。 但是,显示昨天数据的指示器仅在今天日期变化后(即午夜之后)才会显示不同数据,与图层的刷新间隔无关。

选择与限定类型“现在”关联的运算符时,系统会提示您指定单位乘数 (N) 以及时间单位(例如,小时、分钟或秒)或日历单位(例如,天、月、季、年)。

注:

单位乘数必须始终是整数值。 例如,如果您要过滤半天,则过滤器应为 12 小时,而不是 0.5 天。

时间单位从现在(当前时间)开始测量。 例如,如果时间范围在过去 24 小时内,则单位乘数为 24,单位为小时。 范围从现在之前的 24 小时开始,并持续到现在。

带时间单位的日期范围

日历单位包括全天,相对于用户当地时区,从每天范围内的凌晨 12:00:00 到晚上 11:59:59。 例如,如果日期范围在过去 7 天内,则单位乘数为 7,单位为天。 范围从今天前 7 天的凌晨 12:00:00 开始。

带日历单位的日期范围
下表对限定到现在的日期范围进行了说明。 请注意,所有日期值均以您的当地时区为准。

运算符时间单位描述

在过去

秒

现在的 N 秒之前。

分

现在的 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 天的凌晨 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 周后的晚上 11:59:59。

月

从现在开始,一直持续到 N 月后月份的最后一天的晚上 11:59:59。

季度

从现在开始直到 N 季度后季度的最后一天的晚上 11:59:59。

年

从现在开始直到 N 年后年度的最后一天的晚上 11:59:59。

晚于未来

秒

现在之后的 N 秒并继续向后。

分

现在之后的 N 分钟并继续向后。

小时

现在之后的 N 小时并继续向后。

天

当前这一天之后的 N 天的凌晨 12:00:00 开始并继续向后。

周

当前这一周之后的 N 周的凌晨 12:00:00 开始并继续向后。

月

当前这一月之后的 N 月的凌晨 12:00:00 开始并继续向后。

季度

当前这一季度之后的 N 季度的凌晨 12:00:00 开始并继续向后。

年

当前这一年之后的 N 年的凌晨 12:00:00 开始并继续向后。

早于

当前时间

包括到现在为止的所有内容。

晚于

当前时间

包括从现在开始的所有内容。

为

年初至今

当前这一年的 1 月 1 日的凌晨 12:00:00 开始并持续到现在。

不等于

年初至今

排除今年年初至今的所有内容。 今年年初至今从当前这一年的 1 月 1 日的凌晨 12:00:00 开始并持续到现在。

限定到预定义时间段

当您不需要像图层的刷新频率一样频繁地更新数据时,适合使用限定到预定义时间段的日期范围。

选择与预定义限定类型关联的运算符时,需要在时间段选项卡上指定一个间隔。

限定到预定义时间段的日期范围

这些时间段基于以下单位。 请注意,开始和结束时间始终基于您的当地时区。

  • 天 - 一天从凌晨 12:00:00 开始,经过 24 小时,到晚上 11:59:59 结束。对于 24 小时制,一天从 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)。