В MariaDB, DATE_ADD()
е вградена функция за дата и час, която извършва аритметика за дата.
Позволява ви да промените дата, като посочите датата, единицата за добавяне и сумата за добавяне. Можете да подадете отрицателна сума, ако трябва да извадите датата с определен интервал.
Синтаксис
Синтаксисът е така:
DATE_ADD(date,INTERVAL expr unit)
Където date
е датата за промяна, expr
е сумата за добавяне и unit
е единицата дата/час за добавяне (напр. секунда, минута и т.н.).
Пример
Ето един основен пример:
SELECT DATE_ADD('2021-05-31 10:00:00', INTERVAL 1 HOUR);
Резултат:
+--------------------------------------------------+ | DATE_ADD('2021-05-31 10:00:00', INTERVAL 1 HOUR) | +--------------------------------------------------+ | 2021-05-31 11:00:00 | +--------------------------------------------------+
Това е като да направите следното:
SELECT '2021-05-31 10:00:00' + INTERVAL 1 HOUR;
Резултат:
+-----------------------------------------+ | '2021-05-31 10:00:00' + INTERVAL 1 HOUR | +-----------------------------------------+ | 2021-05-31 11:00:00 | +-----------------------------------------+
Отрицателни интервали
Предоставянето на отрицателен интервал изважда тази сума от датата.
Пример:
SELECT DATE_ADD('2021-05-31 10:00:00', INTERVAL -1 HOUR);
Резултат:
+---------------------------------------------------+ | DATE_ADD('2021-05-31 10:00:00', INTERVAL -1 HOUR) | +---------------------------------------------------+ | 2021-05-31 09:00:00 | +---------------------------------------------------+
Други единици
Ето пример, който добавя интервал от 1 към различните единици за дата и час:
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;
Резултат (с помощта на вертикален изход):
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
Съставни единици
Ето пример, който използва съставни единици:
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";
Резултат:
+---------------------+---------------------+---------------------+ | YEAR_MONTH | HOUR_SECOND | DAY_MINUTE | +---------------------+---------------------+---------------------+ | 2022-07-01 10:00:00 | 2021-05-01 11:25:35 | 2021-05-01 11:30:00 | +---------------------+---------------------+---------------------+
Нулеви дати
Предаването на null
за датата връща null
:
SELECT DATE_ADD(null, INTERVAL 1 YEAR);
Резултат:
+---------------------------------+ | DATE_ADD(null, INTERVAL 1 YEAR) | +---------------------------------+ | NULL | +---------------------------------+
Липсващ аргумент
Извикване на DATE_ADD()
с грешен брой аргументи или без подаване на аргументи води до грешка:
SELECT DATE_ADD();
Резултат:
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