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の利用範囲に制限がある環境では、開発環境でこの汎用モジュールの利用可否を確認してください。
参考・関連記事
- 指定した月の月初日・月末日を取得する汎用モジュール:月を移動した後、移動先の月末日が必要な場合に役立ちます。
- 日付の妥当性をチェックする汎用モジュール:外部から受け取った基準日を計算前に検証できます。
- 日付から曜日を取得する汎用モジュール:算出した日付の曜日も表示したい場合に使えます。
- 汎用モジュール一覧:ほかの日付処理を探すときの入口です。