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

Apache Doris 中文参考:QUARTER_CEIL

· 52CE 我爱测

将 、 、 或 值向上取整到最近的指定季度周期起点。如果指定了起始时间(origin),则以该时间为基准计算周期。

描述

将 DATE、DATETIME、TIMESTAMP_NS 或 TIMESTAMPTZ 值向上取整到最近的指定季度周期起点。如果指定了起始时间(origin),则以该时间为基准计算周期。

语法

QUARTER_CEIL(<datetime>)
QUARTER_CEIL(<datetime>, <origin>)
QUARTER_CEIL(<datetime>, <period>)
QUARTER_CEIL(<datetime>, <period>, <origin>)

参数

参数 说明
<datetime> 需要向上取整的日期时间值,支持 DATE、DATETIME、TIMESTAMP_NS 和 TIMESTAMPTZ。
<period> 季度周期值,类型为 INT,表示每个周期包含的季度数
<origin> 周期的起始时间点,支持 DATE、DATETIME、TIMESTAMP_NS 和 TIMESTAMPTZ,默认值为 0001-01-01 00:00:00。

注意:

  • 不指定 period 时,等价于以 1 个季度为周期
  • 当 period 不为正整数时,函数结果将为 NULL
  • 结果总是向未来时间取整
  • 返回值的时间部分总是 00:00:00

返回值

输入为 TIMESTAMP_NS 时返回 TIMESTAMP_NS,并保持固定的 9 位小数秒精度。结果必须位于返回类型的取值范围内;TIMESTAMP_NS 的范围为 [1677-09-21 00:12:43.145224192, 2262-04-11 23:47:16.854775807]。

对 TIMESTAMP_NS 输入省略 <origin> 时,文档中的默认起点仅作为内部对齐基准使用,无需位于 TIMESTAMP_NS 的可存储范围内。

当 <datetime> 为 DATE 类型时,返回类型为 DATE。 当 <datetime> 为 DATETIME 类型时,返回类型为 DATETIME。 当 <datetime> 为 TIMESTAMP_NS 类型时,返回带 9 位小数秒的 TIMESTAMP_NS。 当 <datetime> 为 TIMESTAMPTZ 类型时,返回 TIMESTAMPTZ。 表示向上取整后的日期时间值。结果的时间部分将被设置为 00:00:00。

举例

从 '0001-01-01 00:00:00' 开始,每 5 / 4 个季度为一个周期,返回距离输入日期最近的下一个周期起点。

SELECT QUARTER_CEIL("2023-07-13 22:28:18", 5), QUARTER_CEIL("2023-07-13 22:28:18", 4);
+----------------------------------------+----------------------------------------+
| QUARTER_CEIL("2023-07-13 22:28:18", 5) | QUARTER_CEIL("2023-07-13 22:28:18", 4) |
+----------------------------------------+----------------------------------------+
| 2024-10-01 00:00:00.000000             | 2024-01-01 00:00:00.000000             |
+----------------------------------------+----------------------------------------+

以 '2022-01-01 00:00:00' 为周期起点,分别以 2 / 4 个季度为一个周期,返回距离输入日期最近的下一个周期起点。

SELECT QUARTER_CEIL("2023-03-13 22:28:18", 2, "2022-01-01 00:00:00"), QUARTER_CEIL("2023-07-13 22:28:18", 4, "2022-01-01 00:00:00");
+---------------------------------------------------------------+---------------------------------------------------------------+
| QUARTER_CEIL("2023-03-13 22:28:18", 2, "2022-01-01 00:00:00") | QUARTER_CEIL("2023-07-13 22:28:18", 4, "2022-01-01 00:00:00") |
+---------------------------------------------------------------+---------------------------------------------------------------+
| 2023-07-01 00:00:00                                           | 2024-01-01 00:00:00                                           |
+---------------------------------------------------------------+---------------------------------------------------------------+

最佳实践

还可参阅 date_ceil

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

资料来源与适用范围

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

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

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