Come funziona PERIOD_ADD() in MariaDB

In MariaDB, PERIOD_ADD() è una funzione di data e ora incorporata che aggiunge un determinato numero di mesi a un periodo di tempo.

Il valore restituito è nel formato AAAAMM.

Sintassi

La sintassi è questa:

PERIOD_ADD(P,N)

Dove P è il punto e N è il numero di mesi da aggiungere.

P è nel formato AAMM o AAAAMM e non è un valore di data.

Esempio

Ecco un esempio:

SELECT PERIOD_ADD(202011, 1);

Risultato:

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

Quell'esempio ha aggiunto un mese al periodo.

Eccone uno che aggiunge sei mesi al periodo:

SELECT PERIOD_ADD(202011, 6);

Risultato:

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

Anni a due cifre

Se il primo argomento contiene un anno a due cifre, i valori da 00 a 69 vengono convertiti da 2000 a 2069, mentre i valori da 70 vengono convertiti da 1970 in su.

Esempio:

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

Risultato:

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

Il primo è tornato un anno 2069 e il secondo 1970.

Argomento mancante

Chiamando PERIOD_ADD() con il numero errato di argomenti, o senza passare alcun argomento, si verifica un errore:

SELECT PERIOD_ADD();

Risultato:

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

E un altro esempio:

SELECT PERIOD_ADD( 2010 );

Risultato:

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