V MariaDB, ADDTIME() je vestavěná funkce data a času, která přidává částku k výrazu času nebo data a času.
Umožňuje vám změnit výraz čas nebo datum a čas předáním tohoto výrazu a také výraz času, který se k tomuto výrazu přidá. Pokud potřebujete odečíst z časového výrazu, můžete předat zápornou částku.
Syntaxe
Syntaxe vypadá takto:
ADDTIME(expr1,expr2)
Kde expr1 je výraz čas nebo datum a čas a expr2 je časový výraz.
Příklad
Zde je příklad:
SELECT ADDTIME('10:00:00', '02:30:45'); Výsledek:
+---------------------------------+
| ADDTIME('10:00:00', '02:30:45') |
+---------------------------------+
| 12:30:45 |
+---------------------------------+ Výrazy data a času
První argument může být také výraz datetime:
SELECT ADDTIME('2021-05-01 10:00:00', '22:30:45'); Výsledek:
+--------------------------------------------+
| ADDTIME('2021-05-01 10:00:00', '22:30:45') |
+--------------------------------------------+
| 2021-05-02 08:30:45 |
+--------------------------------------------+ V tomto případě byl přidaný čas dostatečný k posunutí data dopředu na další den a to se odráží ve výsledku.
Časové výrazy ve volnějším formátu
MariaDB umožňuje přiřazení časů ve volnějších formátech, jako je vypuštění úvodních nul a poskytnutí hodnoty pro den.
Proto můžeme udělat toto:
SELECT ADDTIME('2021-05-01 10:00:00', '366 1:1:1.123456'); Výsledek:
+----------------------------------------------------+
| ADDTIME('2021-05-01 10:00:00', '366 1:1:1.123456') |
+----------------------------------------------------+
| 2022-05-02 11:01:01.123456 |
+----------------------------------------------------+ Záporné intervaly
Zadáním záporného intervalu pro část dne se tato částka odečte od času/datu a času.
Příklad:
SELECT ADDTIME('2021-05-01 10:00:00', '-366 1:1:1.123456'); Výsledek:
+-----------------------------------------------------+
| ADDTIME('2021-05-01 10:00:00', '-366 1:1:1.123456') |
+-----------------------------------------------------+
| 2020-04-30 08:58:58.876544 |
+-----------------------------------------------------+ Nulové argumenty
Pokud je některý argument null , výsledkem je null :
SELECT
ADDTIME('10:00:00', null),
ADDTIME(null, '02:30:45'),
ADDTIME(null, null); Výsledek:
+---------------------------+---------------------------+---------------------+
| ADDTIME('10:00:00', null) | ADDTIME(null, '02:30:45') | ADDTIME(null, null) |
+---------------------------+---------------------------+---------------------+
| NULL | NULL | NULL |
+---------------------------+---------------------------+---------------------+ Chybí argument
Volání ADDTIME() s nesprávným počtem argumentů nebo bez předání jakýchkoli argumentů vede k chybě:
SELECT ADDTIME(); Výsledek:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'ADDTIME'