メインコンテンツまでスキップ
バージョン: 4.x

QUARTER_CEIL

説明​

datetime値を指定された四半期期間境界の最も近い上位値に丸めます。起点時刻が指定されている場合、その時刻を基準として期間が計算されます。

ヒント

QUARTER_CEILはバージョン3.0.8および3.1.0以降でサポートされています。

構文​

QUARTER_CEIL(<datetime>)
QUARTER_CEIL(<datetime>, <origin>)
QUARTER_CEIL(<datetime>, <period>)
QUARTER_CEIL(<datetime>, <period>, <origin>)

パラメータ​

パラメータ説明
<datetime>切り上げる日時値、型は DATE または DATETIME
<period>四半期期間値、型は INT、各期間に含まれる四半期数を表す
<origin>期間の開始点、型は DATE または DATETIME、デフォルト値は 0001-01-01 00:00:00

注意事項:

  • period が指定されていない場合、1四半期を期間として使用することと同等
  • period が正の整数でない場合、関数の結果は NULL になる
  • 結果は常に未来の時刻に切り上げられる
  • 戻り値の時刻部分は常に 00:00:00 になる

戻り値​

<datetime> が DATE 型の場合、戻り値の型は DATE です。 <datetime> が DATETIME 型の場合、戻り値の型は DATETIME です。 切り上げられた日時値を表します。結果の時刻部分は 00:00:00 に設定されます。

例​

'0001-01-01 00:00:00' を起点として、それぞれ 5 / 4 四半期の期間で、入力日付に最も近い次の期間開始点を返します。

SELECT QUARTER_CEIL("2023-07-13 22:28:18", 5), QUARTER_CEIL("2023-07-13 22:28:18", 4);
+----------------------------------------+----------------------------------------+
| QUARTER_CEIL("2023-07-13 22:28:18", 5) | QUARTER_CEIL("2023-07-13 22:28:18", 4) |
+----------------------------------------+----------------------------------------+
| 2024-10-01 00:00:00.000000             | 2024-01-01 00:00:00.000000             |
+----------------------------------------+----------------------------------------+

'2022-01-01 00:00:00'を期間開始点として使用し、それぞれ2/4四半期の期間で、入力日付に最も近い次の期間開始点を返します。

SELECT QUARTER_CEIL("2023-03-13 22:28:18", 2, "2022-01-01 00:00:00"), QUARTER_CEIL("2023-07-13 22:28:18", 4, "2022-01-01 00:00:00");
+---------------------------------------------------------------+---------------------------------------------------------------+
| QUARTER_CEIL("2023-03-13 22:28:18", 2, "2022-01-01 00:00:00") | QUARTER_CEIL("2023-07-13 22:28:18", 4, "2022-01-01 00:00:00") |
+---------------------------------------------------------------+---------------------------------------------------------------+
| 2023-07-01 00:00:00                                           | 2024-01-01 00:00:00                                           |
+---------------------------------------------------------------+---------------------------------------------------------------+

ベストプラクティス​

date_ceilも参照してください