SECOND_CEIL
更新时间：2025-10-17
描述
函数用于将输入的日期时间值向上对齐到指定的秒周期边界，并返回对齐后的日期时间值。
语法
SQL
1SECOND_CEIL(<datetime>[, <period>][, <origin_datetime>])参数
| 参数 | 说明 |
|---|---|
<datetime> |
必填，输入的日期时间值，支持 DATETIME 类型。 |
<period> |
可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。 |
<origin_datetime> |
可选，对齐的时间起点，支持 DATETIME 类型。如果未指定，默认为 0001-01-01T00:00:00。 |
返回值
- 返回一个日期时间值，表示输入日期时间向上对齐后的结果。
- 如果输入的
<datetime>为 NULL，返回 NULL。 - 如果输入的
<datetime>为非法日期（如 0000-00-00T00:00:00），返回 NULL。
举例
只指定参数<datetime>
SQL
1SELECT SECOND_CEIL('2025-01-23 12:34:56');
Text
1+-----------------------------------------------------------+
2| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
3+-----------------------------------------------------------+
4| 2025-01-23 12:34:56 |
5+-----------------------------------------------------------+指定参数 <datetime>， <origin_datetime>
SQL
1SELECT SECOND_CEIL('2025-01-23 12:34:56', '2025-01-01 00:00:00');
Text
1+---------------------------------------------------------------------------------------------------------+
2| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
3+---------------------------------------------------------------------------------------------------------+
4| 2025-01-23 12:34:56 |
5+---------------------------------------------------------------------------------------------------------+指定参数 <datetime>，<period>
SQL
1SELECT SECOND_CEIL('2025-01-23 12:34:56', 5)
Text
1+--------------------------------------------------------------+
2| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
3+--------------------------------------------------------------+
4| 2025-01-23 12:35:00 |
5+--------------------------------------------------------------+同时指定 <datetime>，<period>，<origin_datetime>
SQL
1SELECT SECOND_CEIL('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
Text
1+-------------------------------------------------------------------------------------------------------------+
2| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
3+-------------------------------------------------------------------------------------------------------------+
4| 2025-01-23 12:35:00 |
5+-------------------------------------------------------------------------------------------------------------+