TIMESTAMPADD
説明
timestampadd関数は、日付に指定された時間単位（年、月、日、時、分、秒など）を加算するために使用されます。この関数は日付と時刻の計算でよく使用されます。
構文
TIMESTAMPADD(<unit>, <interval>, <datetime_expr>)
パラメータ
| パラメータ | 説明 |
|---|---|
unit | 時間単位、追加する時間単位を指定します。一般的な値にはSECOND、MINUTE、HOUR、DAY、WEEK、MONTH、YEARが含まれます |
interval | 追加する時間間隔、通常は整数で、正または負の値にして時間の長さを加算または減算できます |
datetime_expr | 有効なdatetimeデータ型 |
戻り値
戻り値は新しい日付と時刻で、指定されたタイムスタンプに指定された時間間隔を加算または減算した結果を表します。
入力パラメータが無効な場合、NULLが返されます。
例
SELECT TIMESTAMPADD(MINUTE,1,'2019-01-02');
+------------------------------------------------+
| timestampadd(MINUTE, 1, '2019-01-02 00:00:00') |
+------------------------------------------------+
| 2019-01-02 00:01:00 |
+------------------------------------------------+
SELECT TIMESTAMPADD(WEEK,1,'2019-01-02');
+----------------------------------------------+
| timestampadd(WEEK, 1, '2019-01-02 00:00:00') |
+----------------------------------------------+
| 2019-01-09 00:00:00 |
+----------------------------------------------+
SELECT TIMESTAMPADD(WEEK,1,'1196440219');
+------------------------------------------------------------+
| timestampadd(WEEK, 1, CAST('1196440219' AS datetimev2(6))) |
+------------------------------------------------------------+
| NULL |
+------------------------------------------------------------+