时间和时区

InfluxQL 旨在处理时间序列数据，并包含专门用于处理时间的功能。您可以查看以下在 InfluxQL 查询中使用时间和时间戳的方法

• 时间语法
  • 添加和减去时间值
• 查询时间范围
  • 支持的运算符
• 查询示例
• 时区子句
• 值得注意的行为
  • 无法查询多个时间范围
  • 使用 GROUP BY time() 子句查询未来数据
  • 无法为持续时间使用参数

时间语法

InfluxQL 支持以下时间戳字面量语法

'2006-01-02T15:04:05.00Z' -- RFC3339 date-time string
'2006-01-02 15:04:05.00'  -- RFC3339-like date-time string
1136189045000000000       -- Unix nanosecond epoch time
1136189045s               -- Unix epoch time

• RFC3339 日期-时间字符串：使用 RFC3339 时间戳格式 YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ 的字符串字面量。
• 类 RFC3339 日期-时间字符串：使用类 RFC3339 时间戳格式 YYYY-MM-DD HH:MM:SS.nnnnnnnnn 的字符串字面量。
• Unix 纳秒纪元时间：表示自 Unix 纪元以来经过的纳秒数的整数。
• Unix 纪元时间：表示自 Unix 纪元以来经过的指定时间单位数的持续时间字面量。查看支持的持续时间单位。

支持的时间戳值

添加和减去时间值

时间戳值支持与 持续时间字面量 的加法和减法运算。将持续时间添加到时间戳或从时间戳中减去持续时间以返回更新的时间戳。

'2023-01-01T00:00:00Z' + 2h -- Resolves to 2023-01-01T02:00:00Z
'2023-01-01 00:00:00' - 20h -- Resolves to 2022-12-31T04:00:00Z
1672531200000000000 + 1y    -- Resolves to 2024-01-01T00:00:00Z

查询时间范围

要指定查询的时间范围，请在 WHERE 子句中使用条件表达式，将 time 列的值与绝对时间戳或相对时间戳进行比较。

• 绝对时间范围：使用时间戳字面量定义查询时间边界

  WHERE time >= '2023-01-01T00:00:00Z' AND time <= '2023-07-01T00:00:00Z'
  WHERE time >= '2023-01-01 00:00:00' AND time <= '2023-07-01 00:00:00'
  WHERE time >= 1672531200000000000 AND time <= 1688169600000000000
  WHERE time >= 1672531200s and time <= 1688169600000ms
  

• 相对时间范围：使用添加到或从时间戳字面量中减去的持续时间字面量定义查询时间边界。

  使用 now() 返回当前系统时间 (UTC)。

  -- Query data from the last day
  WHERE time >= now() - 1d
  
  -- Query data from the previous week
  WHERE time >= now() - 1w AND time <= now() - 2w
  
  -- Query data relative to a specific time
  WHERE time >= '2023-01-01' - 1w AND time <= '2023-01-01' + 1w
  

支持的运算符

带有时间操作数的条件表达式支持以下比较运算符

查询示例

以下示例使用 家庭传感器示例数据集。

SELECT *
FROM home
WHERE
  room = 'Kitchen'
  AND time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T12:00:00Z'

SELECT *
FROM home
WHERE
  room = 'Kitchen'
  AND time >= '2022-01-01 08:00:00'
  AND time <= '2022-01-01 12:00:00'

SELECT *
FROM home
WHERE
  room = 'Kitchen'
  AND time >= 1641024000000000000
  AND time <= 1641038400000000000

SELECT *
FROM home
WHERE
  room = 'Kitchen'
  AND time >= 1641024000s
  AND time <= 1641038400s

SELECT * FROM home WHERE time >= '2022-01-01T20:00:00Z' - 2h

SELECT * FROM home WHERE time >= now() - 2h

时区子句

默认情况下，InfluxDB 以 UTC 格式存储和返回时间戳。使用时区子句和 tz() 函数将时区偏移应用于 UTC 时间，并以指定的时区（包括任何适用的季节性偏移，如夏令时 (DST) 或英国夏令时 (BST)）返回时间戳。

SELECT_clause FROM_clause [WHERE_clause] [GROUP_BY_clause] [ORDER_BY_clause] [LIMIT_clause] [OFFSET_clause] [SLIMIT_clause] [SOFFSET_clause] tz('time_zone')

• time_zone：用于调整时间的时区字符串字面量。使用 互联网号码分配机构时区数据库 中定义的时区名称。

时区示例

SELECT *
FROM home
WHERE
  room = 'Kitchen'
  AND time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T12:00:00Z'
tz('America/Chicago')

值得注意的行为

• 无法查询多个时间范围
• 使用 GROUP BY time() 子句查询未来数据
• 无法为持续时间使用参数

无法查询多个时间范围

InfluxDB 不支持在 WHERE 子句中使用 OR 查询多个时间范围。例如，以下查询不返回任何结果

SELECT *
FROM home
WHERE
  (time >= '2022-01-01T08:00:00Z' AND time <= '2022-01-01T10:00:00Z')
  OR (time >= '2022-01-01T18:00:00Z' AND time <= '2022-01-01T20:00:00Z')

使用 GROUP BY time() 子句查询未来数据

在 WHERE 子句中未指定时间范围且不包含 GROUP BY time() 子句的查询使用 最小和最大时间戳 作为默认时间范围。如果查询包含 GROUP BY time() 子句，则默认时间范围介于 1677-09-21T00:12:43.145224193Z 和 now() 之间。

要查询时间戳发生在未来（now() 之后）的数据，请在 WHERE 子句中提供显式上限。

无法为持续时间使用参数

目前，InfluxDB 不支持在 参数化查询 中为持续时间使用参数。