Cómo funciona PERIOD_ADD() en MariaDB

En MariaDB, PERIOD_ADD() es una función de fecha y hora incorporada que agrega una cantidad determinada de meses a un período de tiempo.

El valor devuelto tiene el formato AAAAMM.

Sintaxis

La sintaxis es así:

PERIOD_ADD(P,N)

Donde P es el punto y N es el número de meses para agregarle.

P tiene el formato AAMM o AAAAMM y no es un valor de fecha.

Ejemplo

He aquí un ejemplo:

SELECT PERIOD_ADD(202011, 1);

Resultado:

+-----------------------+
| PERIOD_ADD(202011, 1) |
+-----------------------+
|                202012 |
+-----------------------+

Ese ejemplo agregó un mes al período.

Aquí hay uno que agrega seis meses al período:

SELECT PERIOD_ADD(202011, 6);

Resultado:

+-----------------------+
| PERIOD_ADD(202011, 6) |
+-----------------------+
|                202105 |
+-----------------------+

Años de dos dígitos

Si el primer argumento contiene un año de dos dígitos, los valores del 00 al 69 se convierten del 2000 al 2069, mientras que los valores del 70 se convierten del 1970 en adelante.

Ejemplo:

SELECT 
    PERIOD_ADD(6910, 2),
    PERIOD_ADD(7010, 2);

Resultado:

+---------------------+---------------------+
| PERIOD_ADD(6910, 2) | PERIOD_ADD(7010, 2) |
+---------------------+---------------------+
|              206912 |              197012 |
+---------------------+---------------------+

El primero devolvió un año de 2069 y el segundo de 1970.

Argumento faltante

Llamando a PERIOD_ADD() con el número incorrecto de argumentos, o sin pasar ningún argumento, da como resultado un error:

SELECT PERIOD_ADD();

Resultado:

ERROR 1582 (42000): Incorrect parameter count in the call to native function 'PERIOD_ADD'

Y otro ejemplo:

SELECT PERIOD_ADD( 2010 );

Resultado:

ERROR 1582 (42000): Incorrect parameter count in the call to native function 'PERIOD_ADD'