TIMESTAMPADD

説明

date_add functionと同じ機能です。 TIMESTAMPADD関数は、指定された日時値に指定された単位の指定された時間間隔を加算（または減算）し、計算された日時値を返します。この関数は複数の時間単位（秒、分、時間、日、週、月、年など）をサポートし、日時のオフセット計算を柔軟に処理できます。負の間隔は対応する時間の減算を示します。

この関数はMySQLのtimestampadd functionと一貫した動作をします。

構文

TIMESTAMPADD(<unit>, <interval>, <date_or_time_expr>)

パラメータ

パラメータ	説明
`<unit>`	時間単位、追加する時間単位を指定します。一般的な値にはSECOND、MINUTE、HOUR、DAY、WEEK、MONTH、QUARTER、YEARがあります
`<interval>`	追加する時間間隔、通常は整数で、正または負の値にして時間長の追加または減算を示すことができます
`<date_or_time_expr>`	有効な対象日付、date/datetimeタイプの入力をサポートします。具体的なdatetimeとdateの形式については、datetime conversionとdate conversionを参照してください

戻り値

戻り値は、基準datetimeに指定された間隔を追加した結果を表します。

入力がdateタイプで時間単位がYEAR/MONTH/WEEK/DAYの場合、dateタイプを返します。それ以外の場合はdatetimeタイプを返します
入力がdatetimeタイプの場合、戻り値もdatetimeタイプです
計算結果がDATETIMEタイプの有効範囲（0000-01-01 00:00:00から9999-12-31 23:59:59.999999）を超えた場合、例外をスローします
<datetime_expr>が無効な日付（0000-00-00、2023-13-01など）または<unit>がサポートされていない単位の場合、例外をスローします
いずれかのパラメータがNULLの場合、NULLを返します
月/年を処理する際、月末日付を自動的に適応させます（例：2023-01-31に1ヶ月追加すると、うるう年かどうかに応じて2023-02-28または2023-02-29になります）

例

-- Add 1 minute
SELECT TIMESTAMPADD(MINUTE, 1, '2019-01-02') AS result;
+---------------------+
| result              |
+---------------------+
| 2019-01-02 00:01:00 |
+---------------------+

-- Add 1 week (7 days)
SELECT TIMESTAMPADD(WEEK, 1, '2019-01-02') AS result;
+------------+
| result     |
+------------+
| 2019-01-09 |
+------------+

-- Subtract 3 hours
SELECT TIMESTAMPADD(HOUR, -3, '2023-07-13 10:30:00') AS result;
+---------------------+
| result              |
+---------------------+
| 2023-07-13 07:30:00 |
+---------------------+

-- End of month plus 1 month (automatically adapts to February days)
SELECT TIMESTAMPADD(MONTH, 1, '2023-01-31') AS result;
+------------+
| result     |
+------------+
| 2023-02-28 |
+------------+

-- Cross-year add 1 year
SELECT TIMESTAMPADD(YEAR, 1, '2023-12-31 23:59:59') AS result;
+---------------------+
| result              |
+---------------------+
| 2024-12-31 23:59:59 |
+---------------------+

-- Invalid unit
SELECT TIMESTAMPADD(MIN, 5, '2023-01-01') AS result;
ERROR 1105 (HY000): errCode = 2, detailMessage = Unsupported time stamp diff time unit: MIN, supported time unit: YEAR/MONTH/WEEK/DAY/HOUR/MINUTE/SECOND

-- Any parameter is NULL
SELECT TIMESTAMPADD(YEAR,NULL, '2023-12-31 23:59:59') AS result;
+--------+
| result |
+--------+
| NULL   |
+--------+

-- Unit not supported, invalid
SELECT TIMESTAMPADD(YEAR,10000, '2023-12-31 23:59:59') AS result;
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation years_add of 2023-12-31 23:59:59, 10000 out of range

説明​

構文​

パラメータ​

戻り値​

例​

説明

構文

パラメータ

戻り値

例