Di MariaDB, ADDTIME()
adalah fungsi tanggal dan waktu bawaan yang menambahkan jumlah ke waktu atau ekspresi datetime.
Ini memungkinkan Anda untuk mengubah ekspresi waktu atau datetime dengan meneruskan ekspresi itu, serta ekspresi waktu untuk ditambahkan ke ekspresi itu. Anda dapat memberikan jumlah negatif jika Anda perlu mengurangi dari ekspresi waktu.
Sintaks
Sintaksnya seperti ini:
ADDTIME(expr1,expr2)
Dimana expr1
adalah ekspresi waktu atau datetime, dan expr2
adalah ekspresi waktu.
Contoh
Ini contohnya:
SELECT ADDTIME('10:00:00', '02:30:45');
Hasil:
+---------------------------------+ | ADDTIME('10:00:00', '02:30:45') | +---------------------------------+ | 12:30:45 | +---------------------------------+
Ekspresi Tanggal-waktu
Argumen pertama juga dapat berupa ekspresi datetime:
SELECT ADDTIME('2021-05-01 10:00:00', '22:30:45');
Hasil:
+--------------------------------------------+ | ADDTIME('2021-05-01 10:00:00', '22:30:45') | +--------------------------------------------+ | 2021-05-02 08:30:45 | +--------------------------------------------+
Dalam hal ini, waktu yang ditambahkan sudah cukup untuk mendorong tanggal ke hari berikutnya, dan ini tercermin dalam hasilnya.
Ekspresi Waktu dalam Format yang Lebih Longgar
MariaDB memungkinkan penetapan waktu dalam format yang lebih longgar, seperti menghilangkan angka nol di depan dan memberikan nilai untuk hari itu.
Oleh karena itu, kita dapat melakukan ini:
SELECT ADDTIME('2021-05-01 10:00:00', '366 1:1:1.123456');
Hasil:
+----------------------------------------------------+ | ADDTIME('2021-05-01 10:00:00', '366 1:1:1.123456') | +----------------------------------------------------+ | 2022-05-02 11:01:01.123456 | +----------------------------------------------------+
Interval Negatif
Memberikan interval negatif untuk porsi hari akan mengurangi jumlah tersebut dari waktu/tanggal.
Contoh:
SELECT ADDTIME('2021-05-01 10:00:00', '-366 1:1:1.123456');
Hasil:
+-----------------------------------------------------+ | ADDTIME('2021-05-01 10:00:00', '-366 1:1:1.123456') | +-----------------------------------------------------+ | 2020-04-30 08:58:58.876544 | +-----------------------------------------------------+
Argumen Null
Jika ada argumen null
, hasilnya null
:
SELECT
ADDTIME('10:00:00', null),
ADDTIME(null, '02:30:45'),
ADDTIME(null, null);
Hasil:
+---------------------------+---------------------------+---------------------+ | ADDTIME('10:00:00', null) | ADDTIME(null, '02:30:45') | ADDTIME(null, null) | +---------------------------+---------------------------+---------------------+ | NULL | NULL | NULL | +---------------------------+---------------------------+---------------------+
Argumen Tidak Ada
Memanggil ADDTIME()
dengan jumlah argumen yang salah, atau tanpa memberikan argumen apa pun menghasilkan kesalahan:
SELECT ADDTIME();
Hasil:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'ADDTIME'