CALENDAR_ADD_X_PERIODS

構文


calendar_add_x_periods.epsの説明が続きます
図calendar_add_x_periods.epsの説明

目的

これらのファンクションは、グレゴリオ暦に基づいて、指定された日付から指定された数の期間を加算(または間隔が負の場合は減算)します。

  • dtexprは、DATE、TIMESTAMP、TIMESTAMP WITH TIME ZONE、TIMESTAMP WITH LOCAL TIME ZONEのいずれかの型(または暗黙的にDATEに変換できる任意の値)を持つ日時式です。

  • num_periodsパラメータは、正の場合は期間が加算され、負の場合は期間が減算される整数です。

  • nlsparamは、NLSパラメータ設定を表すテキスト式です。現在サポートされているパラメータはNLS_DATE_LANGUAGEのみで、TO_CHARおよびTO_DATEと同じ方法で指定されます。

CALENDAR_ADD_X_PERIODS、FISCAL_ADD_X_PERIODSおよびRETAIL_ADD_X_PERIODSファンクションは、指定されたdtexprに追加する期間(年、四半期、月、週、日)の数を示すnum_periodsパラメータを使用します。このファンクションは、DATEを戻します(指定されたDATEで保持される時間/分/秒のコンポーネントが含まれます)。

CALENDAR_ADD_YEARSは、指定された年数を加算または減算します。年は常に12か月の期間として定義されます。

CALENDAR_ADD_QUARTERSは、指定された四半期数を加算または減算します。この場合、四半期は常に3か月の期間として定義されます。

CALENDAR_ADD_MONTHSは、既存のADD_MONTHSファンクションと同じです。これにより、対象月を取得するために加算または減算されます。指定した日付が月の最終日の場合、または結果の月の日数が指定した日付の日コンポーネントよりも少ない場合、結果として得られる月の最終日が使用されます。それ以外の場合、結果は指定された日付と同じ日コンポーネントになります。

CALENDAR_ADD_WEEKSは、指定された週数を加算または減算します。週は常に7日の期間として定義されます。

CALENDAR_ADD_DAYSは、指定された日数を加算または減算します。