In MariaDB, PERIOD_ADD()
ist eine eingebaute Datums- und Uhrzeitfunktion, die einem Zeitraum eine bestimmte Anzahl von Monaten hinzufügt.
Der Rückgabewert hat das Format YYYYMM.
Syntax
Die Syntax lautet wie folgt:
PERIOD_ADD(P,N)
Wobei P
der Punkt ist und N
ist die Anzahl der Monate, die hinzugefügt werden sollen.
P
hat das Format JJMM oder JJJJMM und ist kein Datumswert.
Beispiel
Hier ist ein Beispiel:
SELECT PERIOD_ADD(202011, 1);
Ergebnis:
+-----------------------+ | PERIOD_ADD(202011, 1) | +-----------------------+ | 202012 | +-----------------------+
Dieses Beispiel fügte dem Zeitraum einen Monat hinzu.
Hier ist einer, der den Zeitraum um sechs Monate verlängert:
SELECT PERIOD_ADD(202011, 6);
Ergebnis:
+-----------------------+ | PERIOD_ADD(202011, 6) | +-----------------------+ | 202105 | +-----------------------+
Zweistellige Jahreszahlen
Wenn das erste Argument eine zweistellige Jahreszahl enthält, werden Werte von 00 bis 69 in 2000 bis 2069 konvertiert, während Werte von 70 in 1970 aufwärts konvertiert werden.
Beispiel:
SELECT
PERIOD_ADD(6910, 2),
PERIOD_ADD(7010, 2);
Ergebnis:
+---------------------+---------------------+ | PERIOD_ADD(6910, 2) | PERIOD_ADD(7010, 2) | +---------------------+---------------------+ | 206912 | 197012 | +---------------------+---------------------+
Der erste gab das Jahr 2069 zurück und der zweite 1970.
Fehlendes Argument
Aufruf von PERIOD_ADD()
mit der falschen Anzahl von Argumenten oder ohne Übergabe von Argumenten führt zu einem Fehler:
SELECT PERIOD_ADD();
Ergebnis:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'PERIOD_ADD'
Und noch ein Beispiel:
SELECT PERIOD_ADD( 2010 );
Ergebnis:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'PERIOD_ADD'