years_sub

Описание

Вычитает указанное количество лет из указанной даты и времени или даты.

Синтаксис

DATETIME YEARS_SUB(DATETIME date, INT years)

Параметры

date: Исходная дата и время, типа DATETIME или DATE.

years: Количество лет для вычитания. Значение может быть отрицательным, но год даты минус years не может превышать 10000. Например, если год даты равен 2022, то years не может быть меньше -7979. В то же время, years не может превышать значение года даты, например, если значение года даты равно 2022, то years не может быть больше 2022.

Возвращаемое значение

Тип возвращаемого значения такой же, как у параметра date. Возвращает NULL, если результирующий год выходит за пределы диапазона [0, 9999].

Примеры

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