date_ceil

Description

Syntax

DATETIME DATE_CEIL(DATETIME datetime, INTERVAL period type)

Convert the date to the nearest rounding up time of the 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 [(none)]>select date_ceil("2023-07-13 22:28:18",interval 5 second);
  2. +--------------------------------------------------------------+
  3. | second_ceil('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
  4. +--------------------------------------------------------------+
  5. | 2023-07-13 22:28:20 |
  6. +--------------------------------------------------------------+
  7. 1 row in set (0.01 sec)
  8. mysql [(none)]>select date_ceil("2023-07-13 22:28:18",interval 5 minute);
  9. +--------------------------------------------------------------+
  10. | minute_ceil('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
  11. +--------------------------------------------------------------+
  12. | 2023-07-13 22:30:00 |
  13. +--------------------------------------------------------------+
  14. 1 row in set (0.01 sec)
  15. mysql [(none)]>select date_ceil("2023-07-13 22:28:18",interval 5 hour);
  16. +------------------------------------------------------------+
  17. | hour_ceil('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
  18. +------------------------------------------------------------+
  19. | 2023-07-13 23:00:00 |
  20. +------------------------------------------------------------+
  21. 1 row in set (0.01 sec)
  22. mysql [(none)]>select date_ceil("2023-07-13 22:28:18",interval 5 day);
  23. +-----------------------------------------------------------+
  24. | day_ceil('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
  25. +-----------------------------------------------------------+
  26. | 2023-07-15 00:00:00 |
  27. +-----------------------------------------------------------+
  28. 1 row in set (0.00 sec)
  29. mysql [(none)]>select date_ceil("2023-07-13 22:28:18",interval 5 month);
  30. +-------------------------------------------------------------+
  31. | month_ceil('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
  32. +-------------------------------------------------------------+
  33. | 2023-12-01 00:00:00 |
  34. +-------------------------------------------------------------+
  35. 1 row in set (0.01 sec)
  36. mysql [(none)]>select date_ceil("2023-07-13 22:28:18",interval 5 year);
  37. +------------------------------------------------------------+
  38. | year_ceil('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
  39. +------------------------------------------------------------+
  40. | 2026-01-01 00:00:00 |
  41. +------------------------------------------------------------+
  42. 1 row in set (0.00 sec)

Keywords

  1. DATE_CEIL,DATE,CEIL

Best Practices

See also