CEIL (日時)

構文

目的

CEIL(datetime)は、2番目の引数の書式モデルfmtで指定された単位に切り上げられた日付またはタイムスタンプを戻します。入力値が、指定された単位まですでに切り捨てられている場合、戻り値は入力と同じです。つまり、datetime = TRUNC(datetime, fmt)の場合、CEIL(datetime, fmt) = datetimeです。たとえば、CEIL(DATE '2023-02-01', 'MONTH')は2023年2月1日を戻します。

このファンクションは、NLS_CALENDARセッション・パラメータの影響を受けません。このファンクションはグレゴリオ暦の規則に従って動作します。戻される値は、この引数に異なる日時データ型を指定した場合でも、常にDATEデータ型です。2番目の引数が未指定の場合は、デフォルトの書式モデル'DD'が使用されます。

関連項目:

fmtで使用できる書式モデルについては、「CEIL、FLOOR、ROUNDおよびTRUNC日付ファンクション」を参照してください。

例

これらの例では、NLS_DATE_FORMATが次のように設定されています。

ALTER SESSION SET NLS_DATE_FORMAT = 'DD-MON-YYYY HH24:MI:SS';

SELECT CEIL(TO_DATE ('28-FEB-2023','DD-MON-YYYY'), 'MM') AS month_ceiling;

MONTH_CEILING
--------------------
01-MAR-2023 00:00:00

SELECT CEIL(TO_TIMESTAMP ('28-FEB-2023 14:10:10','DD-MON-YYYY HH24:MI:SS'),'HH24') AS hour_ceiling;

HOUR_CEILING
--------------------
28-FEB-2023 15:00:00