Comment fonctionne DATE_SUB() dans MariaDB

Dans MariaDB, DATE_SUB() est une fonction de date et d'heure intégrée qui vous permet de soustraire un montant d'une date.

Il vous permet de modifier une date en spécifiant la date, l'unité à soustraire et le montant à soustraire. Vous pouvez passer un montant négatif afin d'ajouter à la date, au lieu de la soustraire.

Syntaxe

La syntaxe ressemble à ceci :

DATE_SUB(date,INTERVAL expr unit)

Où date est la date à modifier, expr est le montant à soustraire, et unit est l'unité de date/heure à soustraire (par exemple seconde, minute, etc.).

Exemple

Voici un exemple de base :

SELECT DATE_SUB('2021-05-31 10:00:00', INTERVAL 1 HOUR);

Résultat :

+--------------------------------------------------+
| DATE_SUB('2021-05-31 10:00:00', INTERVAL 1 HOUR) |
+--------------------------------------------------+
| 2021-05-31 09:00:00                              |
+--------------------------------------------------+

Cela revient à faire ce qui suit :

SELECT '2021-05-31 10:00:00' - INTERVAL 1 HOUR;

Résultat :

+-----------------------------------------+
| '2021-05-31 10:00:00' - INTERVAL 1 HOUR |
+-----------------------------------------+
| 2021-05-31 09:00:00                     |
+-----------------------------------------+

Intervalles négatifs

Fournir un intervalle négatif ajoute ce montant à compter de la date.

Exemple :

SELECT DATE_SUB('2021-05-31 10:00:00', INTERVAL -1 HOUR);

Résultat :

+---------------------------------------------------+
| DATE_SUB('2021-05-31 10:00:00', INTERVAL -1 HOUR) |
+---------------------------------------------------+
| 2021-05-31 11:00:00                               |
+---------------------------------------------------+

Autres unités

Voici un exemple qui ajoute un intervalle de 1 aux différentes unités de date et d'heure :

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;

Résultat (en utilisant la sortie verticale) :

       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

Unités composites

Voici un exemple qui utilise des unités composées :

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";

Résultat :

+---------------------+---------------------+---------------------+
| YEAR_MONTH          | HOUR_SECOND         | DAY_MINUTE          |
+---------------------+---------------------+---------------------+
| 2020-03-01 10:00:00 | 2021-05-01 08:34:25 | 2021-05-01 08:30:00 |
+---------------------+---------------------+---------------------+

Dates nulles

Passer null pour la date renvoie null :

SELECT DATE_SUB(null, INTERVAL 1 YEAR);

Résultat :

+---------------------------------+
| DATE_SUB(null, INTERVAL 1 YEAR) |
+---------------------------------+
| NULL                            |
+---------------------------------+

Argument manquant

Appel de DATE_SUB() avec le mauvais nombre d'arguments, ou sans passage d'arguments, une erreur se produit :

SELECT DATE_SUB();

Résultat :

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