years_sub

years_sub

Description

指定した日付時刻または日付から指定した年数を引きます。

Syntax

DATETIME YEARS_SUB(DATETIME date, INT years)

Parameters

date: オリジナルの日付時刻、DATETIMEまたはDATEの型です。

years: 引く年数です。値は負の値でも構いませんが、dateの年からyearsを引いた結果は10000を超えてはいけません。例えば、dateの年が2022年の場合、yearsは-7979未満にすることはできません。同時に、yearsはdateの年の値を超えることもできません。例えば、dateの年の値が2022の場合、yearsは2022よりも大きくすることはできません。

Return value

戻り値の型はパラメータdateと同じです。結果の年が範囲[0, 9999]から外れる場合、NULLを返します。

Examples

select years_sub("2022-12-20 15:50:21", 2);
+-------------------------------------+
| years_sub('2022-12-20 15:50:21', 2) |
+-------------------------------------+
| 2020-12-20 15:50:21                 |
+-------------------------------------+