Como PERIOD_ADD() funciona no MariaDB

No MariaDB, PERIOD_ADD() é uma função de data e hora integrada que adiciona um determinado número de meses a um período de tempo.

O valor de retorno está no formato YYYYMM.

Sintaxe

A sintaxe fica assim:

PERIOD_ADD(P,N)

Onde P é o período e N é o número de meses para adicionar a ele.

P está no formato YYMM ou YYYYMM e não é um valor de data.

Exemplo

Aqui está um exemplo:

SELECT PERIOD_ADD(202011, 1);

Resultado:

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

Esse exemplo adicionou um mês ao período.

Aqui está um que adiciona seis meses ao período:

SELECT PERIOD_ADD(202011, 6);

Resultado:

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

Anos de dois dígitos

Se o primeiro argumento contiver um ano de dois dígitos, os valores de 00 a 69 serão convertidos de 2000 a 2069, enquanto os valores de 70 serão convertidos de 1970 para cima.

Exemplo:

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

Resultado:

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

O primeiro retornou um ano de 2069 e o segundo de 1970.

Argumento ausente

Chamando PERIOD_ADD() com o número errado de argumentos, ou sem passar nenhum argumento, resulta em um erro:

SELECT PERIOD_ADD();

Resultado:

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

E outro exemplo:

SELECT PERIOD_ADD( 2010 );

Resultado:

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