文档文档

将值转换为不同类型

使用 CAST 函数或双冒号 :: 强制类型转换简写语法将值转换为特定类型。

-- CAST function
SELECT CAST(1234.5 AS BIGINT)

-- Double-colon casting shorthand
SELECT 1234.5::BIGINT

转换操作可以应用于列表达式或字面值。例如,以下查询使用 Home sensor 示例数据 并且

  • time 列中的所有值转换为整数(Unix 纳秒时间戳)。
  • 将字面字符串值 '1234' 转换为 64 位浮点数,用于每一行。
SELECT
  time::BIGINT AS unix_time,
  '1234'::DOUBLE AS string_to_float
FROM home
LIMIT 5
SELECT
  CAST(time AS BIGINT) AS unix_time,
  CAST('1234' AS DOUBLE) AS string_to_float
FROM home
LIMIT 5
unix_timestring_to_float
16410240000000000001234
16410276000000000001234
16410312000000000001234
16410348000000000001234
16410384000000000001234

转换为字符串类型

在转换操作中使用 STRINGCHARVARCHARTEXT 类型将值转换为字符串。

value::STRING
value::CHAR
value::VARCHAR
value::TEXT
CAST(value AS STRING)
CAST(value AS CHAR)
CAST(value AS VARCHAR)
CAST(value AS TEXT)

SQL 支持将以下内容转换为字符串值

  • 浮点数
  • 整数
  • 无符号整数
  • 布尔值
  • 时间戳

转换为数字类型

InfluxDB SQL 实现支持 64 位浮点数 (DOUBLE)、整数 (BIGINT) 和无符号整数 (BIGINT UNSIGNED)。

转换为浮点数

在转换操作中使用 DOUBLE 类型将值转换为 64 位浮点数。

value::DOUBLE
CAST(value AS DOUBLE)

SQL 支持将以下内容转换为浮点数值

  • 字符串:返回数字字符串的浮点数等效值 ([0-9])。也支持以下字符串模式

    • 科学计数法 ('123.4E+10')
    • 无穷大 ('±Inf')
    • NaN ('NaN')
  • 整数

  • 无符号整数

转换为整数

在转换操作中使用 BIGINT 类型将值转换为 64 位有符号整数。

value::BIGINT
CAST(value AS BIGINT)

SQL 支持将以下内容转换为整数

  • 字符串:返回数字字符串的整数等效值 ([0-9])。
  • 浮点数:截断浮点数的小数部分。
  • 无符号整数:返回无符号整数的有符号整数等效值。
  • 布尔值:对于 true 返回 1,对于 false 返回 0
  • 时间戳:返回等效的 纳秒 epoch 时间戳

转换为无符号整数

在转换操作中使用 BIGINT UNSIGNED 类型将值转换为 64 位无符号整数。

value::BIGINT UNSIGNED
CAST(value AS BIGINT UNSIGNED)

SQL 支持将以下内容转换为无符号整数

  • 字符串:返回数字字符串的无符号整数等效值 ([0-9])。
  • 浮点数:截断浮点数的小数部分。
  • 整数:返回有符号整数的无符号整数等效值。
  • 布尔值:对于 true 返回 1,对于 false 返回 0
  • 时间戳:返回等效的 纳秒 epoch 时间戳

转换为布尔类型

在转换操作中使用 BOOLEAN 类型将值转换为布尔值。

value::BOOLEAN
CAST(value AS BOOLEAN)

SQL 支持将以下内容转换为布尔值

  • Strings
    • 返回 true
      • 'true' (不区分大小写)
      • 't', (不区分大小写)
      • '1'
    • 返回 false
      • 'false' (不区分大小写)
      • 'f' (不区分大小写)
      • '0'
  • 整数
    • 返回 true:正的非零整数
    • 返回 false0
  • 无符号整数
    • 返回 true:非零无符号整数
    • 返回 false0

转换为时间戳类型

在转换操作中使用 TIMESTAMP 类型将值转换为时间戳。

value::TIMESTAMP
CAST(value AS TIMESTAMP)

SQL 支持将以下内容转换为时间戳

  • 字符串:返回字符串值的等效时间戳。支持以下 RFC3339 和 RFC3339 风格的字符串模式

    • YYYY-MM-DDT00:00:00.000Z
    • YYYY-MM-DDT00:00:00.000-00:00
    • YYYY-MM-DD 00:00:00.000-00:00
    • YYYY-MM-DDT00:00:00Z
    • YYYY-MM-DD 00:00:00.000
    • YYYY-MM-DD 00:00:00
    • YYYY-MM-DD
  • 整数:将整数解析为 Unix 时间戳并返回等效时间戳。

  • 无符号整数:将无符号整数解析为 Unix 纳秒时间戳并返回等效时间戳。

将 Unix 纳秒时间戳转换为时间戳类型

要将 Unix 纳秒时间戳转换为时间戳类型,请先将数值转换为无符号整数 (BIGINT UNSIGNED),然后再转换为时间戳。您也可以使用 [to_timestamp_nanos](/influxdb3/core/reference/sql/functions/time-and-date/> #to_timestamp_nanos) 函数。

1704067200000000000::BIGINT UNSIGNED::TIMESTAMP
CAST(CAST(1704067200000000000 AS BIGINT UNSIGNED) AS TIMESTAMP)
to_timestamp_nanos(1704067200000000000)

时间戳函数

您还可以使用以下 SQL 函数将值转换为时间戳类型


此页面是否有帮助?

感谢您的反馈!


InfluxDB 3.8 新特性

InfluxDB 3.8 和 InfluxDB 3 Explorer 1.6 的主要增强功能。

查看博客文章

InfluxDB 3.8 现已适用于 Core 和 Enterprise 版本,同时发布了 InfluxDB 3 Explorer UI 的 1.6 版本。本次发布着重于操作成熟度,以及如何更轻松地部署、管理和可靠地运行 InfluxDB。

更多信息,请查看

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

在 **2026 年 2 月 3 日**,InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。

如果使用 Docker 来安装和运行 InfluxDB,latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。例如,如果使用 Docker 运行 InfluxDB v2,请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2