FISCAL_ADD_X_PERIODS

目的

このクラスのファンクションの会計バリアントは、カレンダに関する前述の定義と同等です。違いは、月を構成するものと関係があります。会計年度の開始が月の1日である場合、これらのファンクションは対応するカレンダの値とまったく同じ値を戻します。ただし、会計年度の開始が1日でない場合、異なる値を戻します。

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

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

  • すべての会計ファンクションは、会計年度の開始の月と日を定義するオプションのfiscal_year_startパラメータを取ります。

    fiscal_year_startパラメータが指定されている場合、これは会計年度の最初の日を表すDATETIMESTAMPTIMESTAMP WITH TIME ZONEまたはTIMESTAMP WITH LOCAL TIME ZONE型の式です。月および日以外のすべてのコンポーネントは無視されます。

    fiscal_year_startファンクションの引数が指定されていない場合は、CALENDAR_FISCAL_YEAR_STARTシステム/セッション・パラメータの値が使用されます(指定されていない場合は、デフォルトで1月1日になります)。CALENDAR_FISCAL_YEAR_STARTシステム/セッション・パラメータは、NLS_DATE_FORMATを使用してDATEに変換されるテキスト値です。オプションの2番目のパラメータ値は、次のような明示的な書式を使用するように指定できます:

    ALTER SESSION SET CALENDAR_FISCAL_YEAR_START = '01-JUN-2025', 'DD-MON-YYYY'
  • nlsparamは、NLSパラメータ設定を表すテキスト式です。現在サポートされているパラメータはNLS_DATE_LANGUAGEのみで、TO_CHARおよびTO_DATEと同じ方法で指定されます。

FISCAL_ADD_YEARSは、指定された年数を加算または減算します。年は常に12か月の期間として定義されます。月の処理方法については、次を参照してください。

FISCAL_ADD_QUARTERSは、指定された四半期数を加算または減算します。四半期は常に3か月の期間として定義されます。月の処理方法については、次を参照してください。

FISCAL_ADD_MONTHS これは、CALENDAR_ADD_MONTHSと同じように処理されます。会計年度の開始が月の最初の日でない場合、指定された月の日の位置付けがターゲット月の対応する位置付けの日にマップされます。開始日の位置付けが開始会計月の最終日である場合、または開始日の位置付けがターゲット会計月の日数より後の場合に、同じルールが適用されます。

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

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