大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:time_slice

· 52CE 我爱测

根据指定的时间粒度周期,将给定的时间转化为其所在的时间粒度周期的起始或结束时刻。

time_slice

根据指定的时间粒度周期,将给定的时间转化为其所在的时间粒度周期的起始或结束时刻。

该函数从 2.3 版本开始支持。从 2.5 版本开始支持转化为结束时刻。

语法

DATETIME time_slice(DATETIME dt, INTERVAL N type[, boundary])

参数说明

  • dt:需要转化的时间。支持的数据类型为 DATETIME。

  • INTERVAL N type:时间粒度周期,例如 interval 5 second 表示时间粒度为 5 秒。

    • N 是 INT 类型的时间粒度周期的长度。
    • type 是时间粒度周期的单位,取值可以是 YEAR,QUARTER,MONTH,WEEK,DAY,HOUR,MINUTE,SECOND,MILLISECOND(3.1.7 及以后),MICROSECOND(3.1.7 及以后)。
  • boundary:可选,用于指定返回时间周期的起始时刻 (FLOOR) 还是结束时刻 (CEIL)。取值范围:FLOOR,CEIL。如果不指定,默认为 FLOOR。该参数从 2.5 版本开始支持。

返回值说明

返回值的数据类型为 DATETIME。

注意事项

时间粒度周期从公元 0001-01-01 00:00:00 算起。

示例

假设有表 test_all_type_select,数据以 id_int 排序:

select * from test_all_type_select order by id_int;
+------------+---------------------+--------+
| id_date    | id_datetime         | id_int |
+------------+---------------------+--------+
| 2052-12-26 | 1691-12-23 04:01:09 |      0 |
| 2168-08-05 | 2169-12-18 15:44:31 |      1 |
| 1737-02-06 | 1840-11-23 13:09:50 |      2 |
| 2245-10-01 | 1751-03-21 00:19:04 |      3 |
| 1889-10-27 | 1861-09-12 13:28:18 |      4 |
+------------+---------------------+--------+
5 rows in set (0.06 sec)

示例一:将给定的 DATETIME 时间 id_datetime 转化为以 5 秒为时间粒度周期的起始时刻(不指定 boundary 参数,默认为 FLOOR)。

select time_slice(id_datetime, interval 5 second)
from test_all_type_select
order by id_int;
+---------------------------------------------------+
| time_slice(id_datetime, INTERVAL 5 second, floor) |
+---------------------------------------------------+
| 1691-12-23 04:01:05                               |
| 2169-12-18 15:44:30                               |
| 1840-11-23 13:09:50                               |
| 1751-03-21 00:19:00                               |
| 1861-09-12 13:28:15                               |
+---------------------------------------------------+
5 rows in set (0.16 sec)

示例二:将给定的 DATETIME 时间 id_datetime 转化为以 5 天为时间粒度周期的起始时刻(设置 boundary 为 FLOOR)。

select time_slice(id_datetime, interval 5 day, FLOOR)
from test_all_type_select
order by id_int;
+------------------------------------------------+
| time_slice(id_datetime, INTERVAL 5 day, floor) |
+------------------------------------------------+
| 1691-12-22 00:00:00                            |
| 2169-12-16 00:00:00                            |
| 1840-11-21 00:00:00                            |
| 1751-03-18 00:00:00                            |
| 1861-09-12 00:00:00                            |
+------------------------------------------------+
5 rows in set (0.15 sec)

示例三:将给定的 DATETIME 时间 id_datetime 转化为以 5 天为时间粒度周期的结束时刻。

select time_slice(id_datetime, interval 5 day, CEIL)
from test_all_type_select
order by id_int;
+-----------------------------------------------+
| time_slice(id_datetime, INTERVAL 5 day, ceil) |
+-----------------------------------------------+
| 1691-12-27 00:00:00                           |
| 2169-12-21 00:00:00                           |
| 1840-11-26 00:00:00                           |
| 1751-03-23 00:00:00                           |
| 1861-09-17 00:00:00                           |
+-----------------------------------------------+

示例四:将给定的 DATETIME 时间 id_datetime 转化为以 1 毫秒为时间粒度周期的结束时刻。

select id_datetime, time_slice(id_datetime, interval 1 millisecond, CEIL)
from test_all_type_select
order by id_int;
+---------------------+-------------------------------------------------------+
| id_datetime         | time_slice(id_datetime, INTERVAL 1 millisecond, ceil) |
+---------------------+-------------------------------------------------------+
| 1691-12-23 04:01:09 | 1691-12-23 04:01:09.001000                            |
| 2169-12-18 15:44:31 | 2169-12-18 15:44:31.001000                            |
| 1840-11-23 13:09:50 | 1840-11-23 13:09:50.001000                            |
| 1751-03-21 00:19:04 | 1751-03-21 00:19:04.001000                            |
| 1861-09-12 13:28:18 | 1861-09-12 13:28:18.001000                            |
+---------------------+-------------------------------------------------------+

示例五:将给定的 DATETIME 时间 id_datetime 转化为以 1 微秒为时间粒度周期的结束时刻。

select id_datetime, time_slice(id_datetime, interval 1 microsecond, CEIL)
from test_all_type_select
order by id_int;
+---------------------+-------------------------------------------------------+
| id_datetime         | time_slice(id_datetime, INTERVAL 1 microsecond, ceil) |
+---------------------+-------------------------------------------------------+
| 1691-12-23 04:01:09 | 1691-12-23 04:01:09.000001                            |
| 2169-12-18 15:44:31 | 2169-12-18 15:44:31.000001                            |
| 1840-11-23 13:09:50 | 1840-11-23 13:09:50.000001                            |
| 1751-03-21 00:19:04 | 1751-03-21 00:19:04.000001                            |
| 1861-09-12 13:28:18 | 1861-09-12 13:28:18.000001                            |
+---------------------+-------------------------------------------------------+

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。