years_sub

説明

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

構文

DATETIME YEARS_SUB(DATETIME date, INT years)

パラメータ

• date: 元の日付時刻。DATETIME または DATE 型。
• years: 引く年数。この値は負の値でも構いませんが、日付の年から years を引いた結果が 10000 を超えてはいけません。例えば、日付の年が 2022 の場合、years は -7979 より小さくできません。同時に、years は日付の年の値を超えてはいけません。例えば、日付の年の値が 2022 の場合、years は 2022 より大きくできません。

戻り値

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

例

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                 |
+-------------------------------------+