ABAPでnヶ月後・前の日付を計算する|MONTH_PLUS_DETERMINEの使い方

ABAPで基準日の「3ヶ月後」や「2ヶ月前」を求めるとき、単純に30日を足し引きしたり、年月の文字列を直接書き換えたりすると、年またぎや月ごとの日数を考慮する必要があります。月単位の日付計算には、汎用モジュール MONTH_PLUS_DETERMINE を利用できます。名称の末尾は DETERMINE(最後にEがある)ので、SE37で検索するときも注意してください。

MONTH_PLUS_DETERMINEの引数と戻り値

基準日を OLDDATE、加減算する月数を MONTHS に渡すと、計算後の日付が NEWDATE に返ります。MONTHS が正なら未来、負なら過去の月へ移動します。

パラメータ方向内容
OLDDATE入力計算の基準日(ABAPの日付型)
MONTHS入力加算・減算する月数。減算時は負数
NEWDATE出力計算後の日付

3ヶ月後の日付を取得するコード例

次の例では、2024年11月15日から3ヶ月後の 2025年2月15日 を取得します。年をまたぐ場合も月数を指定するだけです。

DATA lv_base_date TYPE d VALUE '20241115'.
DATA lv_new_date  TYPE d.

CALL FUNCTION 'MONTH_PLUS_DETERMINE'
  EXPORTING
    months  = 3
    olddate = lv_base_date
  IMPORTING
    newdate = lv_new_date.

" lv_new_date = '20250215'

過去の日付はMONTHSに負数を渡す

過去の月へ戻したい場合は MONTHS を負数にします。同じ基準日から2ヶ月前なら、months = -2 と指定し、結果は 2024年9月15日 です。

CALL FUNCTION 'MONTH_PLUS_DETERMINE'
  EXPORTING
    months  = -2
    olddate = lv_base_date
  IMPORTING
    newdate = lv_new_date.

" lv_new_date = '20240915'

実装前に確認したいこと

  • 「1ヶ月」は30日固定ではありません。 月数による移動と日数の加算は別の計算です。仕様書でどちらを求めるか確認してください。
  • 月末・うるう日は境界値としてテストします。 1月31日や2月29日を基準にした場合、業務が「翌月の同日相当」と「移動先の月末」のどちらを求めるかを先に決めます。月末を必ず返す要件なら、月移動後に月末日を求める処理を組み合わせます。
  • 外部入力の日付は先に検証します。 初期値や存在しない日付をそのまま計算に渡さず、入力チェックを行います。また、ABAP CloudなどAPIの利用範囲に制限がある環境では、開発環境でこの汎用モジュールの利用可否を確認してください。

参考・関連記事

関連記事

PAGE TOP