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

Apache Doris 中文参考:PERIOD_ADD

· 52CE 我爱测

其中 是一个整数,最后两位表示月份(01-12),前面的数字表示年份。 函数返回计算后的周期,格式为整数(年份+月份)。

描述

计算周期 <period>增加 <month> 个月的结果。

其中 <period> 是一个整数,最后两位表示月份(01-12),前面的数字表示年份。 函数返回计算后的周期,格式为整数(年份+月份)。

若年份部分小于 100 会按一定规则补为四位数年份格式处理。 如: PERIOD_ADD(2501, 0) 会返回 202501, 而不是2501。

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

语法

PERIOD_ADD(`<period>`, `<month>`)

参数

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

返回值

返回一个整型,代表计算之后得到的周期。格式为YYYYMM。 同参数说明,年份部分不一定为四位数字。

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

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

举例

SELECT `period`, `month`, PERIOD_ADD(`period`, `month`) AS ans FROM test_period_add;
+----------+--------+----------+
| period   | month  | ans      |
+----------+--------+----------+
|   200803 |      2 |   200805 |
|   200809 |      5 |   200902 |
|      803 |      2 |   200805 |
|     6910 |      3 |   207001 |
|     7001 |      1 |   197002 |
| 12345611 | 123456 | 13374411 |
|     NULL |     10 |     NULL |
|   202510 |   NULL |     NULL |
+----------+--------+----------+
-- 月份部分超出范围[1, 12]
SELECT PERIOD_ADD(202513, 1);
-- ERROR 1105 (HY000): errCode = 2, detailMessage = (127.0.0.1)[INVALID_ARGUMENT]Period function got invalid period: 202513

-- period 超出BIGINT范围
SELECT PERIOD_ADD(-1, 1);
-- ERROR 1105 (HY000): errCode = 2, detailMessage = (127.0.0.1)[INVALID_ARGUMENT]Period function got invalid period: -1
SELECT PERIOD_ADD(9223372036854775807, 1);
+------------------------------------+
| PERIOD_ADD(9223372036854775807, 1) |
+------------------------------------+
|               -9223372036854775808 |
+------------------------------------+

解释: 在 Doris 内部使用int64_t进行计算,所以会存在数值溢出的情况,此行为与 MySQL 一致。

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

资料来源与适用范围

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

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

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