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

Apache Doris 中文参考:PERIOD_DIFF

· 52CE 我爱测

## 描述 计算两个周期之间的月份差值。 其中 是一个整数,最后两位表示月份(01-12),前面的数字表示年份。 函数返回period_1 - period_2的绝对结果。 若年份部分小于 100 会按一定规则补为四位数年份格式处理。 该函数与 MySQL 的 PERIOD_DIFF 函数 行为一致。 ## 语法 ## 参数 | 参数 | 说明 | |---------------|---------------------------

描述

计算两个周期之间的月份差值。

其中 <period> 是一个整数,最后两位表示月份(01-12),前面的数字表示年份。 函数返回period_1 - period_2的绝对结果。

若年份部分小于 100 会按一定规则补为四位数年份格式处理。

该函数与 MySQL 的 PERIOD_DIFF 函数 行为一致。

语法

PERIOD_DIFF(`<period_1>`, `<period_2>`)

参数

参数 说明
<period_1> 代表一个由年和月组成的周期。
  • 格式:月份固定占末尾两位,必须在 [1, 12] 范围内。前面的数字表示年份,年份位数不限,可以超过四位。
  • 年份推断:年份取值直接使用除最后两位外的所有数字。当年份为两位数(范围:[00, 99]), 此时若年份小于 70 则解读为 20YY,若大于等于 70 则解读为 19YY。
  • 值范围:接受 [0, 2^63-1] 范围内的整型参数。
<period_2> 代表另一个周期,格式要求与 <period_1> 相同。

返回值

返回一个整型,表示<period_1> 的总月份数减去 <period_2> 的总月份数的值。

当任一参数为 NULL,因数值无法转换为 BIGINT 时,返回 NULL。

当参数为负数或其月份部分无效时,函数将报错。

举例

SELECT `period_1`, `period_2`, PERIOD_DIFF(`period_1`, `period_2`) AS DIFF FROM `test_period_diff`;
+---------------------+----------+---------------------+
| period_1            | period_2 | DIFF                |
+---------------------+----------+---------------------+
| 200802              |   200703 |                  11 |
| 200703              |   200802 |                 -11 |
| 7001                |     6912 |               -1199 |
| NULL                |     2510 |                NULL |
| 2510                |     NULL |                NULL |
| 9223372036854775807 |      101 | 1106804644422549090 |
| 9223372036854775808 |      101 |                NULL |
+---------------------+----------+---------------------+

最后一行中period_1超出了BIGINT的上限(2^63-1), 故输出 NULL

SELECT PERIOD_DIFF(1, -1);
-- ERROR 1105 (HY000): errCode = 2, detailMessage = (127.0.0.1)[INVALID_ARGUMENT]Period function got invalid period: -1

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

资料来源与适用范围

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

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

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