Comment PERIOD_ADD() fonctionne dans MariaDB

Dans MariaDB, PERIOD_ADD() est une fonction de date et d'heure intégrée qui ajoute un nombre donné de mois à une période de temps.

La valeur de retour est au format AAAAMM.

Syntaxe

La syntaxe ressemble à ceci :

PERIOD_ADD(P,N)

Où P est le point et N est le nombre de mois à ajouter.

P est au format AAMM ou AAAAMM et n'est pas une valeur de date.

Exemple

Voici un exemple :

SELECT PERIOD_ADD(202011, 1);

Résultat :

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

Cet exemple a ajouté un mois à la période.

En voici une qui ajoute six mois à la période :

SELECT PERIOD_ADD(202011, 6);

Résultat :

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

Années à deux chiffres

Si le premier argument contient une année à deux chiffres, les valeurs de 00 à 69 sont converties de 2000 à 2069, tandis que les valeurs de 70 sont converties à partir de 1970.

Exemple :

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

Résultat :

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

Le premier a renvoyé une année 2069 et le second 1970.

Argument manquant

Appel de PERIOD_ADD() avec le mauvais nombre d'arguments, ou sans passer d'arguments, génère une erreur :

SELECT PERIOD_ADD();

Résultat :

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

Et un autre exemple :

SELECT PERIOD_ADD( 2010 );

Résultat :

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