date_floor

Description

Syntax

DATETIME DATE_FLOOR(DATETIME datetime, INTERVAL period type)

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

The datetime parameter is a valid date expression.

The period parameter specifies how many units each cycle consists of, starting from 0001-01-01T00:00:00

Type: YEAR, MONTH, DAY, HOUR, MINUTE, SECOND.

Example

  1. mysql>select date_floor("0001-01-01 00:00:16",interval 5 second);
  2. +---------------------------------------------------------------+
  3. | second_floor('0001-01-01 00:00:16', 5, '0001-01-01 00:00:00') |
  4. +---------------------------------------------------------------+
  5. | 0001-01-01 00:00:15 |
  6. +---------------------------------------------------------------+
  7. 1 row in set (0.00 sec)
  8. mysql>select date_floor("0001-01-01 00:00:18",interval 5 second);
  9. +---------------------------------------------------------------+
  10. | second_floor('0001-01-01 00:00:18', 5, '0001-01-01 00:00:00') |
  11. +---------------------------------------------------------------+
  12. | 0001-01-01 00:00:15 |
  13. +---------------------------------------------------------------+
  14. 1 row in set (0.01 sec)
  15. mysql>select date_floor("2023-07-13 22:28:18",interval 5 minute);
  16. +---------------------------------------------------------------+
  17. | minute_floor('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
  18. +---------------------------------------------------------------+
  19. | 2023-07-13 22:25:00 |
  20. +---------------------------------------------------------------+
  21. 1 row in set (0.00 sec)
  22. mysql>select date_floor("2023-07-13 22:28:18",interval 5 hour);
  23. +-------------------------------------------------------------+
  24. | hour_floor('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
  25. +-------------------------------------------------------------+
  26. | 2023-07-13 18:00:00 |
  27. +-------------------------------------------------------------+
  28. 1 row in set (0.01 sec)
  29. mysql>select date_floor("2023-07-13 22:28:18",interval 5 day);
  30. +------------------------------------------------------------+
  31. | day_floor('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
  32. +------------------------------------------------------------+
  33. | 2023-07-10 00:00:00 |
  34. +------------------------------------------------------------+
  35. 1 row in set (0.00 sec)
  36. mysql>select date_floor("2023-07-13 22:28:18",interval 5 month);
  37. +--------------------------------------------------------------+
  38. | month_floor('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
  39. +--------------------------------------------------------------+
  40. | 2023-07-01 00:00:00 |
  41. +--------------------------------------------------------------+
  42. 1 row in set (0.01 sec)
  43. mysql>select date_floor("2023-07-13 22:28:18",interval 5 year);
  44. +-------------------------------------------------------------+
  45. | year_floor('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
  46. +-------------------------------------------------------------+
  47. | 2021-01-01 00:00:00 |
  48. +-------------------------------------------------------------+

Keywords

  1. DATE_FLOOR,DATE,FLOOR

Best Practices

See also