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

Apache Doris 中文参考:MONTHS_DIFF

· 52CE 我爱测

MONTHS_DIFF 函数用于计算两个日期时间值之间的整数月份差值,返回结果为 减去 后的月份数。该函数支持处理 DATE、DATETIME、TIMESTAMP_NS 类型,仅基于日期部分(年、月、日)计算,忽略时间部分(时、分、秒)。

描述

MONTHS_DIFF 函数用于计算两个日期时间值之间的整数月份差值,返回结果为 <enddate> 减去 <startdate> 后的月份数。该函数支持处理 DATE、DATETIME、TIMESTAMP_NS 类型,仅基于日期部分(年、月、日)计算,忽略时间部分(时、分、秒)。

语法

MONTHS_DIFF(`<date_or_time_expr1>`, `<date_or_time_expr2>`)

参数

参数 说明
<date_or_time_expr1> 结束日期,支持输入 DATE/DATETIME/TIMESTAMP_NS 类型,具体 datetime 和 date 格式请查看 datetime 的转换 和 date 的转换。
<date_or_time_expr2> 开始日期,支持输入 DATE/DATETIME/TIMESTAMP_NS 类型

返回值

返回 <date_or_time_expr1> 减去 <date_or_time_expr2> 所得月份数,类型为 BIGINT.

基础差值 =(结束年份 - 开始年份)× 12 +(结束月份 - 开始月份); 若结束日期的「日部分」< 开始日期的「日部分」,则最终结果 = 基础差值 - 1; 其他情况,最终结果 = 基础差值。

  • 若 <date_or_time_expr1> 早于 <date_or_time_expr2>,返回负值(计算逻辑同上,仅符号相反);
  • 若任一参数为 NULL,返回 NULL;
  • 会考虑实际是否相差 一个月(包括天,时 等部分)

举例

--- 年月差为1,且结束日 < 开始日(结果减1)
SELECT MONTHS_DIFF('2020-03-28', '2020-02-29') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

--- 年月差为1,且结束日 = 开始日
SELECT MONTHS_DIFF('2020-03-29', '2020-02-29') AS result;
+--------+
| result |
+--------+
|      1 |
+--------+

--- 年月差为1,且结束日 > 开始日
SELECT MONTHS_DIFF('2020-03-30', '2020-02-29') AS result;
+--------+
| result |
+--------+
|      1 |
+--------+

--- 结束日期早于开始日期(负值逻辑同理)
SELECT MONTHS_DIFF('2020-02-29', '2020-03-28') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

SELECT MONTHS_DIFF('2020-02-29', '2020-03-29') AS result;
+--------+
| result |
+--------+
|     -1 |
+--------+

--- 同一月份(结果为0)
SELECT MONTHS_DIFF('2023-07-15', '2023-07-30') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

--会考虑月以下的单位
mysql> SELECT MONTHS_DIFF('2020-03-28', '2020-01-29') AS result;
+--------+
| result |
+--------+
|      1 |
+--------+

mysql> SELECT MONTHS_DIFF('2020-03-28 22:22:22', '2020-02-29 23:12:12') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

--- 输入为NULL(返回NULL)
SELECT MONTHS_DIFF(NULL, '2023-01-01') AS result;
+--------+
| result |
+--------+
| NULL   |
+--------+

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

资料来源与适用范围

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

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

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