{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/kmrvvdak7","result":{"data":{"markdownRemark":{"html":"

本页是 SQL 查询中可用的时间日期标量函数参考，涵盖当前时间获取、时间分桶、日期构造、timestamp 格式转换与解析等操作。时序场景专用的扩展函数（date_bin_gapfill、date_bin_wallclock、tz、覆盖版 to_timestamp 等）见本页末尾的时序扩展函数章节。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

函数	别名	说明
`current_date`	`today`	返回当前 UTC 日期
`current_time`	—	返回当前 UTC 时间
`date_bin`	—	按指定间隔分桶，返回 timestamp 所在区间的起点
`date_part`	`datepart`	以整数形式返回日期的指定部分
`date_trunc`	`datetrunc`	将 timestamp 截断到指定精度
`from_unixtime`	—	将整数转换为 RFC3339 timestamp
`make_date`	—	由年 / 月 / 日构造日期
`now`	`current_timestamp`	返回当前 UTC timestamp
`to_char`	`date_format`	按 Chrono 格式输出日期时间的字符串表示
`to_date`	—	将值转换为日期
`to_local_time`	—	将带时区的 timestamp 转换为不带时区的 timestamp
`to_timestamp_micros`	—	将值转换为微秒精度 timestamp
`to_timestamp_millis`	—	将值转换为毫秒精度 timestamp
`to_timestamp_nanos`	—	将值转换为纳秒精度 timestamp
`to_timestamp_seconds`	—	将值转换为秒精度 timestamp
`to_unixtime`	—	将值转换为自 unix epoch 起的秒数

\n

`current_date`

\n

返回当前 UTC 日期。

\n

current_date() 的返回值在查询开始时即确定，无论该函数在查询计划的哪个阶段执行，返回的都是同一个日期。

\n

语法：current_date()

\n

别名：today

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT current_date();\n2+----------------+\n3| current_date() |\n4+----------------+\n5| 2026-07-21     |\n6+----------------+

\n

\n

\n

\n \n

结果为查询开始时刻的值，随执行时间变化。

\n

`current_time`

\n

返回当前 UTC 时间。

\n

current_time() 的返回值在查询开始时即确定，无论该函数在查询计划的哪个阶段执行，返回的都是同一个时间。

\n

语法：current_time()

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT current_time();\n2+--------------------+\n3| current_time()     |\n4+--------------------+\n5| 09:28:52.326720808 |\n6+--------------------+

\n

\n

\n

\n \n

结果为查询开始时刻的值，随执行时间变化。

\n

`date_bin`

\n

计算时间区间，并返回距指定 timestamp 最近的区间起点。使用 date_bin 可以对时序数据降采样：把行按时间分组到「桶」（bin）或「窗口」（window）中，再对每个窗口应用聚合函数或选择器函数。

\n

例如，把数据按 15 分钟为间隔分桶时，输入 timestamp 2023-01-01T18:18:18Z 会被归到它所在的 15 分钟桶的起始时间：2023-01-01T18:15:00Z。

\n

语法：date_bin(interval, expression, origin-timestamp)

\n

参数：

\n

interval：分桶间隔。
expression：要处理的时间表达式，可以是常量、列或函数。
origin-timestamp：可选。用于确定桶边界的起始点。未指定时默认为 1970-01-01T00:00:00Z（UTC 下的 UNIX epoch）。

\n

支持以下 interval：

\n

nanoseconds
microseconds
milliseconds
seconds
minutes
hours
days
weeks
months
years
century

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1-- 将 timestamp 按 1 天间隔分桶\n2> SELECT date_bin(interval '1 day', time) as bin\n3FROM VALUES ('2023-01-01T18:18:18Z'), ('2023-01-03T19:00:03Z')  t(time);\n4+---------------------+\n5| bin                 |\n6+---------------------+\n7| 2023-01-01T00:00:00 |\n8| 2023-01-03T00:00:00 |\n9+---------------------+\n10\n11-- 将 timestamp 按 1 天间隔分桶，桶边界起点为 2023-01-01 的 03:00\n12> SELECT date_bin(interval '1 day', time,  '2023-01-01T03:00:00') as bin\n13FROM VALUES ('2023-01-01T18:18:18Z'), ('2023-01-03T19:00:03Z')  t(time);\n14+---------------------+\n15| bin                 |\n16+---------------------+\n17| 2023-01-01T03:00:00 |\n18| 2023-01-03T03:00:00 |\n19+---------------------+

\n

\n

\n

\n \n

`date_part`

\n

以整数形式返回日期的指定部分。

\n

语法：date_part(part, expression)

\n

也可写作：extract(field FROM source)

\n

参数：

\n

\n
part：要返回的日期部分。支持以下取值：
\n
- year
- quarter（按日期所在的季度返回 [1, 4] 闭区间内的值）
- month
- week（一年中的第几周）
- day（一月中的第几天）
- hour
- minute
- second
- millisecond
- microsecond
- nanosecond
- dow（一周中的第几天）
- doy（一年中的第几天）
- epoch（自 Unix epoch 起的秒数）
\n
expression：要处理的时间表达式，可以是常量、列或函数。

\n

别名：datepart

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT date_part('hour', TIMESTAMP '2024-05-01 08:30:00');\n2+-----------------------------------------------------+\n3| date_part(Utf8("hour"),Utf8("2024-05-01 08:30:00")) |\n4+-----------------------------------------------------+\n5| 8                                                   |\n6+-----------------------------------------------------+

\n

\n

\n

\n \n

`date_trunc`

\n

将 timestamp 值截断到指定精度。

\n

语法：date_trunc(precision, expression)

\n

参数：

\n

\n
precision：截断到的时间精度。支持以下精度：
\n
- year / YEAR
- quarter / QUARTER
- month / MONTH
- week / WEEK
- day / DAY
- hour / HOUR
- minute / MINUTE
- second / SECOND
\n
expression：要处理的时间表达式，可以是常量、列或函数。

\n

别名：datetrunc

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT date_trunc('hour', TIMESTAMP '2024-05-01 08:30:45');\n2+------------------------------------------------------+\n3| date_trunc(Utf8("hour"),Utf8("2024-05-01 08:30:45")) |\n4+------------------------------------------------------+\n5| 2024-05-01T08:00:00                                  |\n6+------------------------------------------------------+

\n

\n

\n

\n \n

`from_unixtime`

\n

将整数转换为 RFC3339 timestamp 格式（YYYY-MM-DDT00:00:00.000000000Z）。整数与无符号整数被解释为自 unix epoch（1970-01-01T00:00:00Z）起的秒数，返回对应的 timestamp。

\n

语法：from_unixtime(expression[, timezone])

\n

参数：

\n

expression：要处理的表达式，可以是常量、列或函数，以及任意运算符组合。
timezone：可选。将整数转换为 timestamp 时使用的时区，未提供时默认时区为 UTC。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> select from_unixtime(1599572549, 'America/New_York');\n2+-----------------------------------------------------------+\n3| from_unixtime(Int64(1599572549),Utf8("America/New_York")) |\n4+-----------------------------------------------------------+\n5| 2020-09-08T09:42:29-04:00                                 |\n6+-----------------------------------------------------------+

\n

\n

\n

\n \n

`make_date`

\n

由年 / 月 / 日各组成部分构造日期。

\n

语法：make_date(year, month, day)

\n

参数：

\n

year：构造日期所用的年份。可以是常量、列或函数，以及任意算术运算符组合。
month：构造日期所用的月份。可以是常量、列或函数，以及任意算术运算符组合。
day：构造日期所用的日。可以是常量、列或函数，以及任意算术运算符组合。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> select make_date(2023, 1, 31);\n2+-------------------------------------------+\n3| make_date(Int64(2023),Int64(1),Int64(31)) |\n4+-------------------------------------------+\n5| 2023-01-31                                |\n6+-------------------------------------------+\n7> select make_date('2023', '01', '31');\n8+-----------------------------------------------+\n9| make_date(Utf8("2023"),Utf8("01"),Utf8("31")) |\n10+-----------------------------------------------+\n11| 2023-01-31                                    |\n12+-----------------------------------------------+

\n

\n

\n

\n \n

`now`

\n

返回当前 UTC timestamp。

\n

now() 的返回值在查询开始时即确定，无论该函数在查询计划的哪个阶段执行，返回的都是同一个 timestamp。

\n

语法：now()

\n

别名：current_timestamp

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT now();\n2+--------------------------------+\n3| now()                          |\n4+--------------------------------+\n5| 2026-07-21T09:28:52.558940990Z |\n6+--------------------------------+

\n

\n

\n

\n \n

结果为查询开始时刻的值，随执行时间变化。

\n

`to_char`

\n

按 Chrono 格式返回 date、time、timestamp 或 duration 的字符串表示。与 PostgreSQL 的同名函数不同，本函数不支持数值格式化。

\n

语法：to_char(expression, format)

\n

参数：

\n

expression：要处理的表达式，可以是结果为 date、time、timestamp 或 duration 的常量、列或函数。
format：用于转换该表达式的 Chrono 格式字符串。

\n

别名：date_format

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> select to_char('2023-03-01'::date, '%d-%m-%Y');\n2+----------------------------------------------+\n3| to_char(Utf8("2023-03-01"),Utf8("%d-%m-%Y")) |\n4+----------------------------------------------+\n5| 01-03-2023                                   |\n6+----------------------------------------------+

\n

\n

\n

\n \n

`to_date`

\n

将值转换为日期（YYYY-MM-DD）。支持字符串、整数和双精度浮点类型作为输入。未提供 Chrono 格式时，字符串按 YYYY-MM-DD 解析（如 '2023-07-20'）。整数和双精度数被解释为自 unix epoch（1970-01-01T00:00:00Z）起的天数。返回对应的日期。

\n

注意：to_date 返回 Date32 类型，其值以带符号 32 位整数存储自 unix epoch（1970-01-01）起的天数。支持的最大日期值为 9999-12-31。

\n

语法：to_date('2017-05-31', '%Y-%m-%d')

\n

参数：

\n

expression：要处理的字符串表达式，可以是常量、列或函数，以及任意运算符组合。
format_n：可选。用于解析表达式的 Chrono 格式字符串，按出现顺序依次尝试，返回第一个成功解析的结果；若所有格式都无法解析该表达式，则返回错误。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> select to_date('2023-01-31');\n2+-----------------------------+\n3| to_date(Utf8("2023-01-31")) |\n4+-----------------------------+\n5| 2023-01-31                  |\n6+-----------------------------+\n7> select to_date('2023/01/31', '%Y-%m-%d', '%Y/%m/%d');\n8+---------------------------------------------------------------+\n9| to_date(Utf8("2023/01/31"),Utf8("%Y-%m-%d"),Utf8("%Y/%m/%d")) |\n10+---------------------------------------------------------------+\n11| 2023-01-31                                                    |\n12+---------------------------------------------------------------+

\n

\n

\n

\n \n

`to_local_time`

\n

将带时区的 timestamp 转换为不带时区的 timestamp（不含偏移量或时区信息）。该函数会处理夏令时切换。

\n

语法：to_local_time(expression)

\n

参数：

\n

expression：要处理的时间表达式，可以是常量、列或函数。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT to_local_time('2024-04-01T00:00:20Z'::timestamp);\n2+---------------------------------------------+\n3| to_local_time(Utf8("2024-04-01T00:00:20Z")) |\n4+---------------------------------------------+\n5| 2024-04-01T00:00:20                         |\n6+---------------------------------------------+\n7\n8> SELECT to_local_time('2024-04-01T00:00:20Z'::timestamp AT TIME ZONE 'Europe/Brussels');\n9+---------------------------------------------+\n10| to_local_time(Utf8("2024-04-01T00:00:20Z")) |\n11+---------------------------------------------+\n12| 2024-04-01T00:00:20                         |\n13+---------------------------------------------+\n14\n15> SELECT\n16  time,\n17  arrow_typeof(time) as type,\n18  to_local_time(time) as to_local_time,\n19  arrow_typeof(to_local_time(time)) as to_local_time_type\n20FROM (\n21  SELECT '2024-04-01T00:00:20Z'::timestamp AT TIME ZONE 'Europe/Brussels' AS time\n22);\n23+---------------------------+------------------------------------------------+---------------------+-----------------------------+\n24| time                      | type                                           | to_local_time       | to_local_time_type          |\n25+---------------------------+------------------------------------------------+---------------------+-----------------------------+\n26| 2024-04-01T00:00:20+02:00 | Timestamp(Nanosecond, Some("Europe/Brussels")) | 2024-04-01T00:00:20 | Timestamp(Nanosecond, None) |\n27+---------------------------+------------------------------------------------+---------------------+-----------------------------+\n28\n29-- 将 to_local_time() 与 date_bin() 结合，按时区本地边界分桶，而非 UTC 边界\n30\n31> SELECT date_bin(interval '1 day', to_local_time('2024-04-01T00:00:20Z'::timestamp AT TIME ZONE 'Europe/Brussels')) AS date_bin;\n32+---------------------+\n33| date_bin            |\n34+---------------------+\n35| 2024-04-01T00:00:00 |\n36+---------------------+\n37\n38> SELECT date_bin(interval '1 day', to_local_time('2024-04-01T00:00:20Z'::timestamp AT TIME ZONE 'Europe/Brussels')) AT TIME ZONE 'Europe/Brussels' AS date_bin_with_timezone;\n39+---------------------------+\n40| date_bin_with_timezone    |\n41+---------------------------+\n42| 2024-04-01T00:00:00+02:00 |\n43+---------------------------+

\n

\n

\n

\n \n

`to_timestamp_micros`

\n

将值转换为 timestamp（YYYY-MM-DDT00:00:00.000000Z）。支持字符串、整数和无符号整数类型作为输入。未提供 Chrono 格式时，字符串按 RFC3339 解析（如 '2023-07-20T05:44:00'）。整数和无符号整数被解释为自 unix epoch（1970-01-01T00:00:00Z）起的微秒数。返回对应的 timestamp。

\n

语法：to_timestamp_micros(expression[, ..., format_n])

\n

参数：

\n

expression：要处理的表达式，可以是常量、列或函数，以及任意算术运算符组合。
format_n：可选。用于解析表达式的 Chrono 格式字符串，按出现顺序依次尝试，返回第一个成功解析的结果；若所有格式都无法解析该表达式，则返回错误。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> select to_timestamp_micros('2023-01-31T09:26:56.123456789-05:00');\n2+------------------------------------------------------------------+\n3| to_timestamp_micros(Utf8("2023-01-31T09:26:56.123456789-05:00")) |\n4+------------------------------------------------------------------+\n5| 2023-01-31T14:26:56.123456                                       |\n6+------------------------------------------------------------------+\n7> select to_timestamp_micros('03:59:00.123456789 05-17-2023', '%c', '%+', '%H:%M:%S%.f %m-%d-%Y');\n8+---------------------------------------------------------------------------------------------------------------+\n9| to_timestamp_micros(Utf8("03:59:00.123456789 05-17-2023"),Utf8("%c"),Utf8("%+"),Utf8("%H:%M:%S%.f %m-%d-%Y")) |\n10+---------------------------------------------------------------------------------------------------------------+\n11| 2023-05-17T03:59:00.123456                                                                                    |\n12+---------------------------------------------------------------------------------------------------------------+

\n

\n

\n

\n \n

`to_timestamp_millis`

\n

将值转换为 timestamp（YYYY-MM-DDT00:00:00.000Z）。支持字符串、整数和无符号整数类型作为输入。未提供 Chrono 格式时，字符串按 RFC3339 解析（如 '2023-07-20T05:44:00'）。整数和无符号整数被解释为自 unix epoch（1970-01-01T00:00:00Z）起的毫秒数。返回对应的 timestamp。

\n

语法：to_timestamp_millis(expression[, ..., format_n])

\n

参数：

\n

expression：要处理的表达式，可以是常量、列或函数，以及任意算术运算符组合。
format_n：可选。用于解析表达式的 Chrono 格式字符串，按出现顺序依次尝试，返回第一个成功解析的结果；若所有格式都无法解析该表达式，则返回错误。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> select to_timestamp_millis('2023-01-31T09:26:56.123456789-05:00');\n2+------------------------------------------------------------------+\n3| to_timestamp_millis(Utf8("2023-01-31T09:26:56.123456789-05:00")) |\n4+------------------------------------------------------------------+\n5| 2023-01-31T14:26:56.123                                          |\n6+------------------------------------------------------------------+\n7> select to_timestamp_millis('03:59:00.123456789 05-17-2023', '%c', '%+', '%H:%M:%S%.f %m-%d-%Y');\n8+---------------------------------------------------------------------------------------------------------------+\n9| to_timestamp_millis(Utf8("03:59:00.123456789 05-17-2023"),Utf8("%c"),Utf8("%+"),Utf8("%H:%M:%S%.f %m-%d-%Y")) |\n10+---------------------------------------------------------------------------------------------------------------+\n11| 2023-05-17T03:59:00.123                                                                                       |\n12+---------------------------------------------------------------------------------------------------------------+

\n

\n

\n

\n \n

`to_timestamp_nanos`

\n

将值转换为 timestamp（YYYY-MM-DDT00:00:00.000000000Z）。支持字符串、整数和无符号整数类型作为输入。未提供 Chrono 格式时，字符串按 RFC3339 解析（如 '2023-07-20T05:44:00'）。整数和无符号整数被解释为自 unix epoch（1970-01-01T00:00:00Z）起的纳秒数。返回对应的 timestamp。

\n

语法：to_timestamp_nanos(expression[, ..., format_n])

\n

参数：

\n

expression：要处理的表达式，可以是常量、列或函数，以及任意算术运算符组合。
format_n：可选。用于解析表达式的 Chrono 格式字符串，按出现顺序依次尝试，返回第一个成功解析的结果；若所有格式都无法解析该表达式，则返回错误。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> select to_timestamp_nanos('2023-01-31T09:26:56.123456789-05:00');\n2+-----------------------------------------------------------------+\n3| to_timestamp_nanos(Utf8("2023-01-31T09:26:56.123456789-05:00")) |\n4+-----------------------------------------------------------------+\n5| 2023-01-31T14:26:56.123456789                                   |\n6+-----------------------------------------------------------------+\n7> select to_timestamp_nanos('03:59:00.123456789 05-17-2023', '%c', '%+', '%H:%M:%S%.f %m-%d-%Y');\n8+--------------------------------------------------------------------------------------------------------------+\n9| to_timestamp_nanos(Utf8("03:59:00.123456789 05-17-2023"),Utf8("%c"),Utf8("%+"),Utf8("%H:%M:%S%.f %m-%d-%Y")) |\n10+--------------------------------------------------------------------------------------------------------------+\n11| 2023-05-17T03:59:00.123456789                                                                                |\n12+---------------------------------------------------------------------------------------------------------------+

\n

\n

\n

\n \n

`to_timestamp_seconds`

\n

将值转换为 timestamp（YYYY-MM-DDT00:00:00.000Z）。支持字符串、整数和无符号整数类型作为输入。未提供 Chrono 格式时，字符串按 RFC3339 解析（如 '2023-07-20T05:44:00'）。整数和无符号整数被解释为自 unix epoch（1970-01-01T00:00:00Z）起的秒数。返回对应的 timestamp。

\n

语法：to_timestamp_seconds(expression[, ..., format_n])

\n

参数：

\n

expression：要处理的表达式，可以是常量、列或函数，以及任意算术运算符组合。
format_n：可选。用于解析表达式的 Chrono 格式字符串，按出现顺序依次尝试，返回第一个成功解析的结果；若所有格式都无法解析该表达式，则返回错误。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> select to_timestamp_seconds('2023-01-31T09:26:56.123456789-05:00');\n2+-------------------------------------------------------------------+\n3| to_timestamp_seconds(Utf8("2023-01-31T09:26:56.123456789-05:00")) |\n4+-------------------------------------------------------------------+\n5| 2023-01-31T14:26:56                                               |\n6+-------------------------------------------------------------------+\n7> select to_timestamp_seconds('03:59:00.123456789 05-17-2023', '%c', '%+', '%H:%M:%S%.f %m-%d-%Y');\n8+----------------------------------------------------------------------------------------------------------------+\n9| to_timestamp_seconds(Utf8("03:59:00.123456789 05-17-2023"),Utf8("%c"),Utf8("%+"),Utf8("%H:%M:%S%.f %m-%d-%Y")) |\n10+----------------------------------------------------------------------------------------------------------------+\n11| 2023-05-17T03:59:00                                                                                            |\n12+----------------------------------------------------------------------------------------------------------------+

\n

\n

\n

\n \n

`to_unixtime`

\n

将值转换为自 unix epoch（1970-01-01T00:00:00Z）起的秒数。支持字符串、日期、timestamp 和双精度浮点类型作为输入。未提供 Chrono 格式时，字符串按 RFC3339 解析（如 '2023-07-20T05:44:00'）。

\n

语法：to_unixtime(expression[, ..., format_n])

\n

参数：

\n

expression：要处理的表达式，可以是常量、列或函数，以及任意算术运算符组合。
format_n：可选。用于解析表达式的 Chrono 格式字符串，按出现顺序依次尝试，返回第一个成功解析的结果；若所有格式都无法解析该表达式，则返回错误。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> select to_unixtime('2020-09-08T12:00:00+00:00');\n2+------------------------------------------------+\n3| to_unixtime(Utf8("2020-09-08T12:00:00+00:00")) |\n4+------------------------------------------------+\n5| 1599566400                                     |\n6+------------------------------------------------+\n7> select to_unixtime('01-14-2023 01:01:30+05:30', '%q', '%d-%m-%Y %H/%M/%S', '%+', '%m-%d-%Y %H:%M:%S%#z');\n8+-----------------------------------------------------------------------------------------------------------------------------+\n9| to_unixtime(Utf8("01-14-2023 01:01:30+05:30"),Utf8("%q"),Utf8("%d-%m-%Y %H/%M/%S"),Utf8("%+"),Utf8("%m-%d-%Y %H:%M:%S%#z")) |\n10+-----------------------------------------------------------------------------------------------------------------------------+\n11| 1673638290                                                                                                                  |\n12+-----------------------------------------------------------------------------------------------------------------------------+

\n

\n

\n

\n \n

时序扩展函数

\n

以下函数是时序场景专用扩展，语义以本节为准。补齐缺口（gap filling）示例统一基于下面这份带缺口的样例数据（temps 表，每分钟一个点，缺 00:02 与 00:03 两分钟）：

\n\n

\n

\n

\n Plain Text\n \n

\n

\n

1+---------------------+------+\n2| time                | temp |\n3+---------------------+------+\n4| 2024-01-01T00:00:00 | 20.0 |\n5| 2024-01-01T00:01:00 | 21.0 |\n6| 2024-01-01T00:04:00 | 24.0 |\n7| 2024-01-01T00:05:00 | 25.0 |\n8+---------------------+------+

\n

\n

\n

\n \n

`date_bin_gapfill`

\n

参数与 date_bin 完全相同，在按固定窗口分箱之外，还会为查询时间范围内没有数据的时间窗生成行。缺口行的聚合值默认为 NULL，可用 locf 或 interpolate 包裹聚合表达式改变填充策略。

\n

语法：date_bin_gapfill(interval, expression[, origin-timestamp])

\n

参数：

\n

interval：分箱窗口宽度（interval 字面量）。
expression：timestamp 表达式，通常是 time 列。
origin：可选，分箱原点时间戳，缺省 1970-01-01T00:00:00Z。

\n

用法约束：

\n

必须出现在 SELECT 列表中，并同时作为 GROUP BY 的分组键。
查询必须对 time 施加有界的范围过滤（上下界都有），否则无法确定要生成的时间窗范围。
该函数只能按上述形态使用，不能脱离这一形态单独调用。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT date_bin_gapfill(INTERVAL '1 minute', time) AS minute, avg(temp) AS avg_temp FROM temps WHERE time >= '2024-01-01T00:00:00Z' AND time < '2024-01-01T00:06:00Z' GROUP BY minute ORDER BY minute;\n2+---------------------+----------+\n3| minute              | avg_temp |\n4+---------------------+----------+\n5| 2024-01-01T00:00:00 | 20.0     |\n6| 2024-01-01T00:01:00 | 21.0     |\n7| 2024-01-01T00:02:00 |          |\n8| 2024-01-01T00:03:00 |          |\n9| 2024-01-01T00:04:00 | 24.0     |\n10| 2024-01-01T00:05:00 | 25.0     |\n11+---------------------+----------+

\n

\n

\n

\n \n

相关函数：locf、interpolate、date_bin_wallclock_gapfill

\n

`locf`

\n

用于补缺口查询的填充策略函数（last observation carried forward）：缺口行的值沿用前一个有数据时间窗的观测值。只能在包含 date_bin_gapfill / date_bin_wallclock_gapfill 的查询里包裹聚合表达式使用，不能单独调用。

\n

语法：locf(aggregate_expression)

\n

参数：

\n

aggregate_expression：要填充的聚合表达式，任意类型。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT date_bin_gapfill(INTERVAL '1 minute', time) AS minute, locf(avg(temp)) AS avg_temp FROM temps WHERE time >= '2024-01-01T00:00:00Z' AND time < '2024-01-01T00:06:00Z' GROUP BY minute ORDER BY minute;\n2+---------------------+----------+\n3| minute              | avg_temp |\n4+---------------------+----------+\n5| 2024-01-01T00:00:00 | 20.0     |\n6| 2024-01-01T00:01:00 | 21.0     |\n7| 2024-01-01T00:02:00 | 21.0     |\n8| 2024-01-01T00:03:00 | 21.0     |\n9| 2024-01-01T00:04:00 | 24.0     |\n10| 2024-01-01T00:05:00 | 25.0     |\n11+---------------------+----------+

\n

\n

\n

\n \n

相关函数：date_bin_gapfill、interpolate

\n

`interpolate`

\n

用于补缺口查询的填充策略函数：缺口行的值由前后相邻观测值线性插值得出，参数必须是数值类型。只能在包含 date_bin_gapfill / date_bin_wallclock_gapfill 的查询里包裹聚合表达式使用，不能单独调用。

\n

语法：interpolate(aggregate_expression)

\n

参数：

\n

aggregate_expression：要插值的聚合表达式，数值类型。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT date_bin_gapfill(INTERVAL '1 minute', time) AS minute, interpolate(avg(temp)) AS avg_temp FROM temps WHERE time >= '2024-01-01T00:00:00Z' AND time < '2024-01-01T00:06:00Z' GROUP BY minute ORDER BY minute;\n2+---------------------+----------+\n3| minute              | avg_temp |\n4+---------------------+----------+\n5| 2024-01-01T00:00:00 | 20.0     |\n6| 2024-01-01T00:01:00 | 21.0     |\n7| 2024-01-01T00:02:00 | 22.0     |\n8| 2024-01-01T00:03:00 | 23.0     |\n9| 2024-01-01T00:04:00 | 24.0     |\n10| 2024-01-01T00:05:00 | 25.0     |\n11+---------------------+----------+

\n

\n

\n

\n \n

相关函数：date_bin_gapfill、locf

\n

`date_bin_wallclock`

\n

与 date_bin 类似，但按输入时间戳所属时区的墙上钟（wallclock）时间划分时间窗：时区取自 expression 参数的数据类型（可先用 tz 转换），结果保持相同类型（含时区）。interval 不支持月和年；origin 必须是不带时区的墙上钟时间，缺省 1970-01-01T00:00:00。

\n

夏令时产生的不存在时间会顺延同等偏移；二义时间在窗口大于两个候选时刻之差时取较早者，否则按输入的 UTC 偏移对齐。数据为 UTC、或窗口远小于夏令时偏移时，建议直接用 date_bin。

\n

语法：date_bin_wallclock(interval, expression[, origin-timestamp])

\n

参数：

\n

interval：分箱窗口宽度（interval 字面量），不支持月和年。
expression：timestamp 表达式，时区取自其数据类型。
origin：可选，不带时区的墙上钟原点，缺省 1970-01-01T00:00:00。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT date_bin_wallclock(INTERVAL '1 day', tz(TIMESTAMP '2024-06-01 20:30:00', 'Asia/Shanghai'));\n2+---------------------------------------------------------------------------------------------------------------------------------------------------------------+\n3| date_bin_wallclock(IntervalMonthDayNano("IntervalMonthDayNano { months: 0, days: 1, nanoseconds: 0 }"),tz(Utf8("2024-06-01 20:30:00"),Utf8("Asia/Shanghai"))) |\n4+---------------------------------------------------------------------------------------------------------------------------------------------------------------+\n5| 2024-06-02T00:00:00+08:00                                                                                                                                     |\n6+---------------------------------------------------------------------------------------------------------------------------------------------------------------+

\n

\n

\n

\n \n

按东八区墙上钟对齐到天边界（2024-06-02T00:00:00+08:00）；同一时刻用 date_bin 按 UTC 对齐，得到的是起点为 2024-06-01T00:00:00Z 的 UTC 天窗口（在东八区偏移下显示为 2024-06-01T08:00:00+08:00），两者边界不同。

\n

相关函数：tz、date_bin_wallclock_gapfill

\n

`date_bin_wallclock_gapfill`

\n

date_bin_wallclock 的补缺口版本：参数与其相同，行为同 date_bin_gapfill（缺口行默认 NULL，可配 locf / interpolate），用法约束也相同（SELECT + GROUP BY、有界时间过滤）。

\n

语法：date_bin_wallclock_gapfill(interval, expression[, origin-timestamp])

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT date_bin_wallclock_gapfill(INTERVAL '1 minute', time) AS minute, avg(temp) AS avg_temp FROM temps WHERE time >= '2024-01-01T00:00:00Z' AND time < '2024-01-01T00:06:00Z' GROUP BY minute ORDER BY minute;\n2+---------------------+----------+\n3| minute              | avg_temp |\n4+---------------------+----------+\n5| 2024-01-01T00:00:00 | 20.0     |\n6| 2024-01-01T00:01:00 | 21.0     |\n7| 2024-01-01T00:02:00 |          |\n8| 2024-01-01T00:03:00 |          |\n9| 2024-01-01T00:04:00 | 24.0     |\n10| 2024-01-01T00:05:00 | 25.0     |\n11+---------------------+----------+

\n

\n

\n

\n \n

相关函数：date_bin_wallclock、locf、interpolate

\n

`tz`

\n

把纳秒 timestamp 转换到指定时区：无时区输入按 UTC 解释，输出带上目标时区偏移。timezone 必须是字符串字面量，接受 IANA 时区名（如 'Asia/Shanghai'）或固定偏移（如 '+08:00'），缺省 'UTC'。通常与 date_bin_wallclock、date_trunc 配合做本地时间分析。

\n

语法：tz(expression[, timezone])

\n

参数：

\n

expression：纳秒 timestamp 表达式，带或不带时区均可。
timezone：可选，目标时区字符串字面量，缺省 'UTC'。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT tz(TIMESTAMP '2024-01-01 00:00:00', 'Asia/Shanghai');\n2+-------------------------------------------------------+\n3| tz(Utf8("2024-01-01 00:00:00"),Utf8("Asia/Shanghai")) |\n4+-------------------------------------------------------+\n5| 2024-01-01T08:00:00+08:00                             |\n6+-------------------------------------------------------+

\n

\n

\n

\n \n

相关函数：date_bin_wallclock、to_local_time

\n

`to_timestamp`

\n

转换为纳秒 timestamp：整数参数按纳秒 Unix 时间解释；timestamp 参数转为纳秒精度；字符串参数按 RFC 3339 或给定的 Chrono 格式串解析。返回值始终为纳秒 timestamp。需要按秒转换时用 to_timestamp_seconds。

\n

语法：to_timestamp(expression[, ..., format_n])

\n

参数：

\n

expression：整数（纳秒 Unix 时间）、timestamp 或字符串表达式。
format_n：可选，仅字符串输入时使用的 Chrono 格式串，按顺序尝试。

\n

示例：

\n\n

\n

\n

\n SQL\n \n

\n

\n

1> SELECT to_timestamp(1704067200000000000);\n2+------------------------------------------+\n3| to_timestamp(Int64(1704067200000000000)) |\n4+------------------------------------------+\n5| 2024-01-01T00:00:00                      |\n6+------------------------------------------+

\n

\n

\n

\n \n

相关函数：to_timestamp_seconds、to_timestamp_millis、to_timestamp_micros、to_timestamp_nanos

","fields":{"slug":"kmrvvdak7","title":"时间日期函数","date":"2026-07-24","extractedHeadings":[]},"headings":[{"value":"current_date","depth":2},{"value":"current_time","depth":2},{"value":"date_bin","depth":2},{"value":"date_part","depth":2},{"value":"date_trunc","depth":2},{"value":"from_unixtime","depth":2},{"value":"make_date","depth":2},{"value":"now","depth":2},{"value":"to_char","depth":2},{"value":"to_date","depth":2},{"value":"to_local_time","depth":2},{"value":"to_timestamp_micros","depth":2},{"value":"to_timestamp_millis","depth":2},{"value":"to_timestamp_nanos","depth":2},{"value":"to_timestamp_seconds","depth":2},{"value":"to_unixtime","depth":2},{"value":"时序扩展函数","depth":2},{"value":"date_bin_gapfill","depth":3},{"value":"locf","depth":3},{"value":"interpolate","depth":3},{"value":"date_bin_wallclock","depth":3},{"value":"date_bin_wallclock_gapfill","depth":3},{"value":"tz","depth":3},{"value":"to_timestamp","depth":3}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"kmrvvdak7","prev":null,"next":null,"parents":[]}}}