years_sub

説明

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

構文

DATETIME YEARS_SUB(DATETIME date, INT years)

パラメータ

• date: 元の日付時刻。DATETIME または DATE 型です。

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