Jak DATE_ADD() funguje v MariaDB

V MariaDB, DATE_ADD() je vestavěná funkce data a času, která provádí aritmetiku data.

Umožňuje vám změnit datum zadáním data, jednotky, kterou chcete přidat, a částky, kterou chcete přidat. Pokud potřebujete odečíst datum o určitý interval, můžete předat zápornou částku.

Syntaxe

Syntaxe vypadá takto:

DATE_ADD(date,INTERVAL expr unit)

Kde date je datum změny, expr je množství, které se má přidat, a unit je jednotka data/času, kterou chcete přidat (např. sekunda, minuta atd.).

Příklad

Zde je základní příklad:

SELECT DATE_ADD('2021-05-31 10:00:00', INTERVAL 1 HOUR);

Výsledek:

+--------------------------------------------------+
| DATE_ADD('2021-05-31 10:00:00', INTERVAL 1 HOUR) |
+--------------------------------------------------+
| 2021-05-31 11:00:00                              |
+--------------------------------------------------+

Je to jako udělat následující:

SELECT '2021-05-31 10:00:00' + INTERVAL 1 HOUR;

Výsledek:

+-----------------------------------------+
| '2021-05-31 10:00:00' + INTERVAL 1 HOUR |
+-----------------------------------------+
| 2021-05-31 11:00:00                     |
+-----------------------------------------+

Záporné intervaly

Zadáním záporného intervalu se tato částka odečte od data.

Příklad:

SELECT DATE_ADD('2021-05-31 10:00:00', INTERVAL -1 HOUR);

Výsledek:

+---------------------------------------------------+
| DATE_ADD('2021-05-31 10:00:00', INTERVAL -1 HOUR) |
+---------------------------------------------------+
| 2021-05-31 09:00:00                               |
+---------------------------------------------------+

Další jednotky

Zde je příklad, který přidává interval 1 k různým jednotkám data a času:

SELECT 
    DATE_ADD('2021-05-01 10:00:00', INTERVAL 1 YEAR) AS YEAR,
    DATE_ADD('2021-05-01 10:00:00', INTERVAL 1 MONTH) AS MONTH,
    DATE_ADD('2021-05-01 10:00:00', INTERVAL 1 DAY) AS DAY,
    DATE_ADD('2021-05-01 10:00:00', INTERVAL 1 HOUR) AS HOUR,
    DATE_ADD('2021-05-01 10:00:00', INTERVAL 1 MINUTE) AS MINUTE,
    DATE_ADD('2021-05-01 10:00:00', INTERVAL 1 SECOND) AS SECOND,
    DATE_ADD('2021-05-01 10:00:00', INTERVAL 1 MICROSECOND) AS MICROSECOND;

Výsledek (při použití vertikálního výstupu):

       YEAR: 2022-05-01 10:00:00
      MONTH: 2021-06-01 10:00:00
        DAY: 2021-05-02 10:00:00
       HOUR: 2021-05-01 11:00:00
     MINUTE: 2021-05-01 10:01:00
     SECOND: 2021-05-01 10:00:01
MICROSECOND: 2021-05-01 10:00:00.000001

Složené jednotky

Zde je příklad použití složených jednotek:

SELECT 
    DATE_ADD('2021-05-01 10:00:00', INTERVAL '1:2' YEAR_MONTH) AS "YEAR_MONTH",
    DATE_ADD('2021-05-01 10:00:00', INTERVAL '1:25:35' HOUR_SECOND) AS "HOUR_SECOND",
    DATE_ADD('2021-05-01 10:00:00', INTERVAL '1:30' DAY_MINUTE) AS "DAY_MINUTE";

Výsledek:

+---------------------+---------------------+---------------------+
| YEAR_MONTH          | HOUR_SECOND         | DAY_MINUTE          |
+---------------------+---------------------+---------------------+
| 2022-07-01 10:00:00 | 2021-05-01 11:25:35 | 2021-05-01 11:30:00 |
+---------------------+---------------------+---------------------+

Neplatná data

Předávání null pro datum vrátí null :

SELECT DATE_ADD(null, INTERVAL 1 YEAR);

Výsledek:

+---------------------------------+
| DATE_ADD(null, INTERVAL 1 YEAR) |
+---------------------------------+
| NULL                            |
+---------------------------------+

Chybí argument

Volání DATE_ADD() s nesprávným počtem argumentů nebo bez předání jakýchkoli argumentů vede k chybě:

SELECT DATE_ADD();

Výsledek:

ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near ')' at line 1