Sådan fungerer ADDTIME() i MariaDB

I MariaDB, ADDTIME() er en indbygget dato- og klokkeslætsfunktion, der tilføjer et beløb til et klokkeslæt eller datetime-udtryk.

Det giver dig mulighed for at ændre et klokkeslæt eller datetime-udtryk ved at videregive det udtryk, såvel som et tidsudtryk, der skal tilføjes til det udtryk. Du kan sende et negativt beløb, hvis du skal trække fra tidsudtrykket.

Syntaks

Syntaksen ser sådan ud:

ADDTIME(expr1,expr2)

Hvor expr1 er et klokkeslæt eller datetime-udtryk, og expr2 er et tidsudtryk.

Eksempel

Her er et eksempel:

SELECT ADDTIME('10:00:00', '02:30:45');

Resultat:

+---------------------------------+
| ADDTIME('10:00:00', '02:30:45') |
+---------------------------------+
| 12:30:45                        |
+---------------------------------+

Dato-tidsudtryk

Det første argument kan også være et datetime-udtryk:

SELECT ADDTIME('2021-05-01 10:00:00', '22:30:45');

Resultat:

+--------------------------------------------+
| ADDTIME('2021-05-01 10:00:00', '22:30:45') |
+--------------------------------------------+
| 2021-05-02 08:30:45                        |
+--------------------------------------------+

I dette tilfælde var den tilføjede tid nok til at rykke datoen frem til næste dag, og det afspejles i resultatet.

Tidsudtryk i et løsere format

MariaDB tillader tildeling af tider i løsere formater, såsom at slippe indledende nuller og angive en værdi for dagen.

Derfor kan vi gøre dette:

SELECT ADDTIME('2021-05-01 10:00:00', '366 1:1:1.123456');

Resultat:

+----------------------------------------------------+
| ADDTIME('2021-05-01 10:00:00', '366 1:1:1.123456') |
+----------------------------------------------------+
| 2022-05-02 11:01:01.123456                         |
+----------------------------------------------------+

Negative intervaller

Hvis du angiver et negativt interval for dagsdelen, trækkes dette beløb fra klokkeslættet/datoen.

Eksempel:

SELECT ADDTIME('2021-05-01 10:00:00', '-366 1:1:1.123456');

Resultat:

+-----------------------------------------------------+
| ADDTIME('2021-05-01 10:00:00', '-366 1:1:1.123456') |
+-----------------------------------------------------+
| 2020-04-30 08:58:58.876544                          |
+-----------------------------------------------------+

Nul-argumenter

Hvis et argument er null , resultatet er null :

SELECT 
    ADDTIME('10:00:00', null),
    ADDTIME(null, '02:30:45'),
    ADDTIME(null, null);

Resultat:

+---------------------------+---------------------------+---------------------+
| ADDTIME('10:00:00', null) | ADDTIME(null, '02:30:45') | ADDTIME(null, null) |
+---------------------------+---------------------------+---------------------+
| NULL                      | NULL                      | NULL                |
+---------------------------+---------------------------+---------------------+

Manglende argument

Kalder ADDTIME() med det forkerte antal argumenter, eller uden at sende nogen argumenter, resulterer det i en fejl:

SELECT ADDTIME();

Resultat:

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