MariaDBでは、ADDDATE() は、日付演算を実行する組み込みの日付と時刻の関数です。
日付、追加する単位、追加する金額を指定して日付を変更できます。日付を一定の間隔で引く必要がある場合は、負の金額を渡すことができます。
ADDDATE() また、日付に特定の日数を追加できるショートカット構文もあります。
構文
ADDDATE() 関数には2つの構文があります。
構文1：
ADDDATE(expr,days)
expr は日付で、days 追加する日数です。
構文2：
ADDDATE(date,INTERVAL expr unit)
date 変更する日付、expr 追加する量であり、unit 追加する単位です（秒、分など）。
この構文を使用する場合、ADDDATE() DATE_ADD()の同義語です 。
例–構文1
最初の構文の使用例は次のとおりです。
SELECT ADDDATE('2021-05-01', 1);結果：
+--------------------------+
| ADDDATE('2021-05-01', 1) |
+--------------------------+
| 2021-05-02 |
+--------------------------+ 必要に応じて時間部分を含めることもできます：
SELECT ADDDATE('2021-05-01 10:00:00', 1);結果：
+-----------------------------------+
| ADDDATE('2021-05-01 10:00:00', 1) |
+-----------------------------------+
| 2021-05-02 10:00:00 |
+-----------------------------------+ 同じことを行う2つの代替方法を次に示します。
SELECT
DATE_ADD('2021-05-01 10:00:00', INTERVAL 1 DAY) AS "Result 1",
'2021-05-01 10:00:00' + INTERVAL 1 DAY AS "Result 2";結果：
+---------------------+---------------------+ | Result 1 | Result 2 | +---------------------+---------------------+ | 2021-05-02 10:00:00 | 2021-05-02 10:00:00 | +---------------------+---------------------+
例–構文2
2番目の構文の使用例は次のとおりです。
SELECT ADDDATE('2021-05-31 10:00:00', INTERVAL 1 HOUR);結果：
+-------------------------------------------------+
| ADDDATE('2021-05-31 10:00:00', INTERVAL 1 HOUR) |
+-------------------------------------------------+
| 2021-05-31 11:00:00 |
+-------------------------------------------------+ この構文により、日付に他の単位を追加できます（つまり、日だけではありません）。ここでは、日付に1時間を追加しましたが、分、秒、月、日、年なども簡単に追加できました。例を読み続けてください。
上記の例と同じ結果を達成するための2つの代替方法を次に示します。
SELECT
DATE_ADD('2021-05-31 10:00:00', INTERVAL 1 HOUR) AS "Result 1",
'2021-05-31 10:00:00' + INTERVAL 1 HOUR AS "Result 2";結果：
+---------------------+---------------------+ | Result 1 | Result 2 | +---------------------+---------------------+ | 2021-05-31 11:00:00 | 2021-05-31 11:00:00 | +---------------------+---------------------+
負の間隔
負の間隔を指定すると、その金額が日付から差し引かれます。
例：
SELECT ADDDATE('2021-05-31 10:00:00', INTERVAL -1 HOUR);結果：
+--------------------------------------------------+
| ADDDATE('2021-05-31 10:00:00', INTERVAL -1 HOUR) |
+--------------------------------------------------+
| 2021-05-31 09:00:00 |
+--------------------------------------------------+ その他のユニット
さまざまな日付と時刻の単位に1の間隔を追加する例を次に示します。
SELECT
ADDDATE('2021-05-01 10:00:00', INTERVAL 1 YEAR) AS YEAR,
ADDDATE('2021-05-01 10:00:00', INTERVAL 1 MONTH) AS MONTH,
ADDDATE('2021-05-01 10:00:00', INTERVAL 1 DAY) AS DAY,
ADDDATE('2021-05-01 10:00:00', INTERVAL 1 HOUR) AS HOUR,
ADDDATE('2021-05-01 10:00:00', INTERVAL 1 MINUTE) AS MINUTE,
ADDDATE('2021-05-01 10:00:00', INTERVAL 1 SECOND) AS SECOND,
ADDDATE('2021-05-01 10:00:00', INTERVAL 1 MICROSECOND) AS MICROSECOND;結果（垂直出力を使用）：
YEAR: 2022-05-01 10:00:00
MONTH: 2021-06-01 10:00:00
DAY: 2021-05-02 10:00:00
HOUR: 2021-05-01 11:00:00
MINUTE: 2021-05-01 10:01:00
SECOND: 2021-05-01 10:00:01
MICROSECOND: 2021-05-01 10:00:00.000001 複合ユニット
複合ユニットを使用する例を次に示します。
SELECT
ADDDATE('2021-05-01 10:00:00', INTERVAL '1:2' YEAR_MONTH) AS "YEAR_MONTH",
ADDDATE('2021-05-01 10:00:00', INTERVAL '1:25:35' HOUR_SECOND) AS "HOUR_SECOND",
ADDDATE('2021-05-01 10:00:00', INTERVAL '1:30' DAY_MINUTE) AS "DAY_MINUTE";結果：
+---------------------+---------------------+---------------------+ | YEAR_MONTH | HOUR_SECOND | DAY_MINUTE | +---------------------+---------------------+---------------------+ | 2022-07-01 10:00:00 | 2021-05-01 11:25:35 | 2021-05-01 11:30:00 | +---------------------+---------------------+---------------------+
ヌル日付
nullを渡す 日付の場合はnullを返します ：
SELECT ADDDATE(null, INTERVAL 1 YEAR);結果：
+--------------------------------+ | ADDDATE(null, INTERVAL 1 YEAR) | +--------------------------------+ | NULL | +--------------------------------+
引数がありません
ADDDATE()を呼び出す 引数の数が間違っているか、引数を渡さないと、エラーが発生します：
SELECT ADDDATE();結果：
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