时间和时区

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 不支持在参数化查询中将参数用于持续时间。