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

Apache Doris 中文参考:MONTH_FLOOR

· 52CE 我爱测

MONTH_FLOOR 函数用于将 、 、 或 值向下取整到最近的指定月份周期。若指定起始时间(origin),则以该时间为基准划分周期并取整;若未指定,默认以 0001-01-01 00:00:00 为基准。

描述

MONTH_FLOOR 函数用于将 DATE、DATETIME、TIMESTAMP_NS 或 TIMESTAMPTZ 值向下取整到最近的指定月份周期。若指定起始时间(origin),则以该时间为基准划分周期并取整;若未指定,默认以 0001-01-01 00:00:00 为基准。

日期时间的计算公式:

$$ \begin{aligned} &\text{month_floor}(\langle\text{date_or_time_expr}\rangle, \langle\text{period}\rangle, \langle\text{origin}\rangle) = \ &\max{\langle\text{origin}\rangle + k \times \langle\text{period}\rangle \times \text{month} \mid \ &k \in \mathbb{Z} \land \langle\text{origin}\rangle + k \times \langle\text{period}\rangle \times \text{month} \leq \langle\text{date_or_time_expr}\rangle} \end{aligned} $$ $k$ 代表的是基准时间到目标时间的周期数

语法

MINUTE_FLOOR(`<date_or_time_expr>`)
MINUTE_FLOOR(`<date_or_time_expr>`, `<origin>`)
MINUTE_FLOOR(`<date_or_time_expr>`, `<period>`)
MINUTE_FLOOR(`<date_or_time_expr>`, `<period>`, `<origin>`)

参数

参数 说明
<date_or_time_expr> 需要向下取整的日期时间值,支持 DATE、DATETIME、TIMESTAMP_NS 和 TIMESTAMPTZ,具体格式请查看 timestamptz 的转换、datetime 的转换和 date 的转换。
<period> 月份周期值,类型为 INT,表示每个周期包含的月数
<origin> 周期的起始时间点,支持 DATE、DATETIME、TIMESTAMP_NS 和 TIMESTAMPTZ,默认值为 0001-01-01 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 的可存储范围内。

返回根据输入参数确定的日期时间类型,表示向下取整到最近的指定月份周期后的时间值。返回值的精度与输入参数一致。

  • 若输入为 TIMESTAMPTZ 类型,则会先将其转换为 local_time(如:2025-12-31 23:59:59+05:00 在会话变量为+08:00的情况下代表的local_time为2026-01-01 02:59:59),再进行 FLOOR 计算操作。
  • 若输入的时间值(<date_or_time_expr> 和<period>)同时包含 TIMESTAMPTZ 和 DATETIME 类型,则输出 DATETIME 类型。
  • 若 <period> 为非正(≤0),返回错误。
  • 若任一参数为 NULL,返回 NULL。
  • 不指定 period 时,默认以 1 分钟为周期。
  • <origin> 未指定,默认以 0001-01-01 00:00:00 为基准。
  • 若输入为 DATE 类型(仅包含年月日),默认其时间部分为 00:00:00。
  • 若 <origin> 日期时间在 <period> 之后,也会按照上述公式计算,不过周期 k 为负数。
  • 若 date_or_time_expr 带有 scale,则返回结果也带有 scale 且小数部分为零.

举例

-- 以默认周期1个月,默认起始时间 0001-01-01 00:00:00
SELECT MONTH_FLOOR('2023-07-13 22:28:18') AS result;
+---------------------+
| result              |
+---------------------+
| 2023-07-01 00:00:00 |
+---------------------+

-- 以5个月为一周期,以默认的起始点的向下取整结果
SELECT MONTH_FLOOR('2023-07-13 22:28:18', 5) AS result;
+---------------------+
| result              |
+---------------------+
| 2023-06-01 00:00:00 |
+---------------------+

-- 输入日期时间恰好是周期起点,则返回输入日期时间
SELECT MONTH_FLOOR('2023-06-01 00:00:00', 5) AS result;
+---------------------+
| result              |
+---------------------+
| 2023-06-01 00:00:00 |
+---------------------+

-- 只有起始日期和指定日期
 select month_floor("2023-07-13 22:28:18", "2023-01-04 00:00:00");
+-----------------------------------------------------------+
| month_floor("2023-07-13 22:28:18", "2023-01-04 00:00:00") |
+-----------------------------------------------------------+
| 2023-07-04 00:00:00                                       |
+-----------------------------------------------------------+

-- 指定起始时间(origin)
SELECT MONTH_FLOOR('2023-07-13 22:28:18', 5, '2023-01-01 00:00:00') AS result;
+---------------------+
| result              |
+---------------------+
| 2023-06-01 00:00:00 |
+---------------------+

--- 带有 scale 的 datetime,会把小数位全部截断为 0
SELECT MINUTE_FLOOR('2023-07-13 22:28:18.456789', 5) AS result;
+----------------------------+
| result                     |
+----------------------------+
| 2023-07-13 22:25:00.000000 |
+----------------------------+

--- 若 <origin> 日期时间在 <period> 之后,也会按照上述公式计算,不过周期 k 为负数。
SELECT MONTH_FLOOR('2022-09-13 22:28:18', 5, '2028-07-03 22:20:00') AS result;
+---------------------+
| result              |
+---------------------+
| 2022-09-03 22:20:00 |
+---------------------+

--- 输入为 DATE 类型(默认时间 00:00:00)
SELECT MINUTE_FLOOR('2023-07-13', 30) AS result;
+---------------------+
| result              |
+---------------------+
| 2023-07-13 00:00:00 |
+---------------------+

-- TimeStampTz类型样例, SET time_zone = '+08:00'
-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 FLOOR 操作
SELECT MONTH_FLOOR('2025-12-31 23:59:59+05:00');
+------------------------------------------+
| MONTH_FLOOR('2025-12-31 23:59:59+05:00') |
+------------------------------------------+
| 2026-01-01 00:00:00+08:00                |
+------------------------------------------+

-- 若参数同时包含 TimeStampTz 和 Datetime 类型,则输出 DateTime 类型
SELECT MONTH_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
+---------------------------------------------------------------------+
| MONTH_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
+---------------------------------------------------------------------+
| 2025-12-15 00:00:00.123                                             |
+---------------------------------------------------------------------+

--- 周期为非正数,返回错误
SELECT MONTH_FLOOR('2023-07-13 22:28:18', -5) AS result;
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation month_floor of 2023-07-13 22:28:18, -5 out of range

--- 任一参数为 NULL,返回 NULL
SELECT MONTH_FLOOR(NULL, 5), MONTH_FLOOR('2023-07-13 22:28:18', NULL) AS result;
+-----------------------+--------+
| month_floor(NULL, 5)  | result |
+-----------------------+--------+
| NULL                  | NULL   |
+-----------------------+--------+

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

资料来源与适用范围

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

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

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