year_floor

year_floor

description

Syntax

DATETIME YEAR_FLOOR(DATETIME datetime)
DATETIME YEAR_FLOOR(DATETIME datetime, DATETIME origin)
DATETIME YEAR_FLOOR(DATETIME datetime, INT period)
DATETIME YEAR_FLOOR(DATETIME datetime, INT period, DATETIME origin)

Convert the date to the nearest rounding down time of the specified time interval period.

• datetime: a valid date expression.
• period: specifies how many years each cycle consists of.
• origin: starting from 0001-01-01T00:00:00.

example

mysql> select year_floor("2023-07-13 22:28:18", 5);
+-------------------------------------------------------------+
| year_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+-------------------------------------------------------------+
| 2020-01-01 00:00:00                                         |
+-------------------------------------------------------------+
1 row in set (0.11 sec)

keywords

YEAR_FLOOR, YEAR, FLOOR

Best Practice

See also date_floor