MariaDB PERIOD_ADD() 函数使用指南

在 MariaDB 中，PERIOD_ADD() 是一个内置函数，它在指定年月上加上指定的月数将结果作为年月返回。

MariaDB PERIOD_ADD() 语法

这是 MariaDB PERIOD_ADD() 函数的语法：

PERIOD_ADD(period, month_number)

参数

period

必需的。使用 YYYYMM 或 YYMM 格式表示的时期。

month_number

必需的。需要加到 period 上的月数。

如果您提供了错误数量的参数，MariaDB 将报告一个错误： ERROR 1582 (42000): Incorrect parameter count in the call to native function 'PERIOD_ADD'。

返回值

MariaDB PERIOD_ADD() 函数在指定年月上加上指定的月数将结果作为年月返回。 PERIOD_ADD() 函数返回值是一个数字，格式是 YYYYMM。

对于两位数年份，MariaDB 的处理规则如下：

• 从 00 到 69 的值将被转换为从 2000 到 2069
• 从 70 到 99 的值将被转换为从 1970 到 1999

如果参数为 NULL，PERIOD_ADD() 函数将返回 NULL。

PERIOD_ADD() 示例

示例 1 - YYYYMM

SELECT
    PERIOD_ADD(202301, 1),
    PERIOD_ADD(202301, 2),
    PERIOD_ADD(202301, 3),
    PERIOD_ADD(202301, 4),
    PERIOD_ADD(202301, 5),
    PERIOD_ADD(202301, 6),
    PERIOD_ADD(202301, 7),
    PERIOD_ADD(202301, 8),
    PERIOD_ADD(202301, 9),
    PERIOD_ADD(202301, 10),
    PERIOD_ADD(202301, 11),
    PERIOD_ADD(202301, 12)\G

输出：

 PERIOD_ADD(202301, 1): 202302
 PERIOD_ADD(202301, 2): 202303
 PERIOD_ADD(202301, 3): 202304
 PERIOD_ADD(202301, 4): 202305
 PERIOD_ADD(202301, 5): 202306
 PERIOD_ADD(202301, 6): 202307
 PERIOD_ADD(202301, 7): 202308
 PERIOD_ADD(202301, 8): 202309
 PERIOD_ADD(202301, 9): 202310
PERIOD_ADD(202301, 10): 202311
PERIOD_ADD(202301, 11): 202312
PERIOD_ADD(202301, 12): 202401

示例 2 - YYMM

对于两位数年份，MariaDB 的处理规则如下：

• 从 00 到 69 的值将被转换为从 2000 到 2069
• 从 70 到 99 的值将被转换为从 1970 到 1999

SELECT
    PERIOD_ADD(0002, 6),
    PERIOD_ADD(6902, 6),
    PERIOD_ADD(7002, 6),
    PERIOD_ADD(9902, 6)\G

输出：

PERIOD_ADD(0002, 6): 200008
PERIOD_ADD(6902, 6): 206908
PERIOD_ADD(7002, 6): 197008
PERIOD_ADD(9902, 6): 199908

结论

在 MariaDB 中，PERIOD_ADD() 是一个内置函数，它在指定年月上加上指定的月数将结果作为年月返回。