MariaDBでのDATE_SUB（）のしくみ

MariaDBでは、DATE_SUB() は、日付から金額を減算できる組み込みの日付と時刻の関数です。

日付、減算する単位、および減算する量を指定することにより、日付を変更できます。日付から減算する代わりに、日付に加算するために負の金額を渡すことができます。

構文

構文は次のようになります：

DATE_SUB(date,INTERVAL expr unit)

date 変更する日付、expr は減算する量であり、unit 減算する日付/時刻の単位です（秒、分など）。

例

基本的な例は次のとおりです。

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

結果：

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

これは、次のようになります。

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

結果：

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

負の間隔

負の間隔を指定すると追加 日付からのその金額。

例：

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

結果：

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

その他のユニット

さまざまな日付と時刻の単位に1の間隔を追加する例を次に示します。

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;

結果（垂直出力を使用）：

       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

複合ユニット

複合ユニットを使用する例を次に示します。

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

結果：

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

ヌル日付

nullを渡す 日付の場合はnullを返します ：

SELECT DATE_SUB(null, INTERVAL 1 YEAR);

結果：

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

引数がありません

DATE_SUB()を呼び出す 引数の数が間違っているか、引数を渡さないと、エラーが発生します：

SELECT DATE_SUB();

結果：

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