MONTH_CEIL
説明
日時の値を指定された月間隔の最も近い値に切り上げます。開始時刻（origin）が提供される場合、間隔の計算の基準としてその時刻を使用します。
構文
MONTH_CEIL(<datetime>)
MONTH_CEIL(<datetime>, <origin>)
MONTH_CEIL(<datetime>, <period>)
MONTH_CEIL(<datetime>, <period>, <origin>)
パラメータ
| パラメータ | 説明 |
|---|---|
<datetime> | 切り上げする日時の値、DATETIME型またはDATETIMEV2型 |
<period> | 月間隔の値、INT型、各間隔の月数を表す |
<origin> | 間隔の開始点、DATETIME型またはDATETIMEV2型；デフォルトは0001-01-01 00:00:00 |
戻り値
DATETIME型の値を返し、切り上げされた日時の値を表します。結果の時間部分は00:00:00に設定されます。
例
SELECT MONTH_CEIL("2023-07-13 22:28:18", 5);
+-------------------------------------------------------------+
| month_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+-------------------------------------------------------------+
| 2023-10-01 00:00:00 |
+-------------------------------------------------------------+
注意:
- 期間が指定されていない場合、デフォルトで1ヶ月間隔になります。
- 期間は正の整数である必要があります。
- 結果は常に将来の時刻に切り上げられます。
- 返される値の時刻部分は常に00:00:00に設定されます。
ベストプラクティス
date_ceilも参照してください
