PERIOD_ADD

描述

计算周期 <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 一致。