W MariaDB, DATE_SUB()
to wbudowana funkcja daty i czasu, która umożliwia odjęcie kwoty od daty.
Pozwala zmienić datę, określając datę, jednostkę do odjęcia i kwotę do odjęcia. Możesz przekazać kwotę ujemną w celu dodania do daty, zamiast odejmowania od niej.
Składnia
Składnia wygląda tak:
DATE_SUB(date,INTERVAL expr unit)
Gdzie date
to data do zmiany, expr
to kwota do odjęcia, a unit
jest jednostką daty/czasu do odjęcia (np. sekunda, minuta itp.).
Przykład
Oto podstawowy przykład:
SELECT DATE_SUB('2021-05-31 10:00:00', INTERVAL 1 HOUR);
Wynik:
+--------------------------------------------------+ | DATE_SUB('2021-05-31 10:00:00', INTERVAL 1 HOUR) | +--------------------------------------------------+ | 2021-05-31 09:00:00 | +--------------------------------------------------+
To tak, jakby wykonać następujące czynności:
SELECT '2021-05-31 10:00:00' - INTERVAL 1 HOUR;
Wynik:
+-----------------------------------------+ | '2021-05-31 10:00:00' - INTERVAL 1 HOUR | +-----------------------------------------+ | 2021-05-31 09:00:00 | +-----------------------------------------+
Przedziały ujemne
Zapewnienie ujemnego przedziału dodaje ta kwota od daty.
Przykład:
SELECT DATE_SUB('2021-05-31 10:00:00', INTERVAL -1 HOUR);
Wynik:
+---------------------------------------------------+ | DATE_SUB('2021-05-31 10:00:00', INTERVAL -1 HOUR) | +---------------------------------------------------+ | 2021-05-31 11:00:00 | +---------------------------------------------------+
Inne jednostki
Oto przykład, który dodaje interwał 1 do różnych jednostek daty i czasu:
SELECT
DATE_SUB('2021-05-10 10:00:00', INTERVAL 1 YEAR) AS YEAR,
DATE_SUB('2021-05-10 10:00:00', INTERVAL 1 MONTH) AS MONTH,
DATE_SUB('2021-05-10 10:00:00', INTERVAL 1 DAY) AS DAY,
DATE_SUB('2021-05-10 10:00:00', INTERVAL 1 HOUR) AS HOUR,
DATE_SUB('2021-05-10 10:00:00', INTERVAL 1 MINUTE) AS MINUTE,
DATE_SUB('2021-05-10 10:00:00', INTERVAL 1 SECOND) AS SECOND,
DATE_SUB('2021-05-10 10:00:00', INTERVAL 1 MICROSECOND) AS MICROSECOND;
Wynik (przy użyciu wyjścia pionowego):
YEAR: 2020-05-10 10:00:00 MONTH: 2021-04-10 10:00:00 DAY: 2021-05-09 10:00:00 HOUR: 2021-05-10 09:00:00 MINUTE: 2021-05-10 09:59:00 SECOND: 2021-05-10 09:59:59 MICROSECOND: 2021-05-10 09:59:59.999999
Jednostki złożone
Oto przykład wykorzystujący jednostki złożone:
SELECT
DATE_SUB('2021-05-01 10:00:00', INTERVAL '1:2' YEAR_MONTH) AS "YEAR_MONTH",
DATE_SUB('2021-05-01 10:00:00', INTERVAL '1:25:35' HOUR_SECOND) AS "HOUR_SECOND",
DATE_SUB('2021-05-01 10:00:00', INTERVAL '1:30' DAY_MINUTE) AS "DAY_MINUTE";
Wynik:
+---------------------+---------------------+---------------------+ | YEAR_MONTH | HOUR_SECOND | DAY_MINUTE | +---------------------+---------------------+---------------------+ | 2020-03-01 10:00:00 | 2021-05-01 08:34:25 | 2021-05-01 08:30:00 | +---------------------+---------------------+---------------------+
Daty zerowe
Przekazywanie null
dla daty zwraca null
:
SELECT DATE_SUB(null, INTERVAL 1 YEAR);
Wynik:
+---------------------------------+ | DATE_SUB(null, INTERVAL 1 YEAR) | +---------------------------------+ | NULL | +---------------------------------+
Brakujący argument
Wywołanie DATE_SUB()
z niewłaściwą liczbą argumentów lub bez przekazania jakichkolwiek argumentów powoduje błąd:
SELECT DATE_SUB();
Wynik:
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