DATE_CEIL

説明

date_ceilは、指定された時間間隔の次の上位境界まで、与えられた日付を切り上げます。

構文

DATE_CEIL(<datetime>, INTERVAL <period> <type>)

パラメータ

Parameter	デスクリプション
datetime	有効な日付式である引数
period	各期間を構成する単位数を指定する引数で、開始時刻は0001-01-01T00:00:00です
type	引数は次のいずれかです：YEAR、MONTH、DAY、HOUR、MINUTE、SECOND

ヒント

QUARTERはバージョン3.0.8および3.1.0からサポートされています。

戻り値

戻り値は日付または時刻で、入力値を指定された単位まで切り上げた結果を表します。

例

select date_ceil("2023-07-13 22:28:18",interval 5 second);

+--------------------------------------------------------------+
| second_ceil('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
+--------------------------------------------------------------+
| 2023-07-13 22:28:20                                          |
+--------------------------------------------------------------+

select date_ceil("2023-07-13 22:28:18",interval 5 minute);
+--------------------------------------------------------------+
| minute_ceil('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
+--------------------------------------------------------------+
| 2023-07-13 22:30:00                                          |
+--------------------------------------------------------------+

select date_ceil("2023-07-13 22:28:18",interval 5 hour);

+------------------------------------------------------------+
| hour_ceil('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
+------------------------------------------------------------+
| 2023-07-13 23:00:00                                        |
+------------------------------------------------------------+

select date_ceil("2023-07-13 22:28:18",interval 5 day);

+-----------------------------------------------------------+
| day_ceil('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
+-----------------------------------------------------------+
| 2023-07-15 00:00:00                                       |
+-----------------------------------------------------------+

select date_ceil("2023-07-13 22:28:18",interval 5 month);

+-------------------------------------------------------------+
| month_ceil('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
+-------------------------------------------------------------+
| 2023-12-01 00:00:00                                         |
+-------------------------------------------------------------+

select date_ceil("2023-07-13 22:28:18",interval 5 quarter);

+-----------------------------------------------------+
| date_ceil("2023-07-13 22:28:18",interval 5 quarter) |
+-----------------------------------------------------+
| 2024-10-01 00:00:00                                 |
+-----------------------------------------------------+

select date_ceil("2023-07-13 22:28:18",interval 5 year);

+------------------------------------------------------------+
| year_ceil('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
+------------------------------------------------------------+
| 2026-01-01 00:00:00                                        |
+------------------------------------------------------------+