帳票や通知文に「令和○年」のような和暦を表示したいとき、SAPに保存している日付を文字列に変換する必要があります。ABAPでは、標準汎用モジュール CONVERSION_EXIT_JPDAT_OUTPUT を使って日付を和暦の表示形式に変換できます。
この記事では、基本的な呼び出し方、元号の切り替わりで確認したい点、変換結果を扱う際の注意をまとめます。
CONVERSION_EXIT_JPDAT_OUTPUTでできること
INPUT にSAP内部形式の日付を渡し、OUTPUT に和暦表示用の値を受け取ります。会計伝票の日付やマスタの日付そのものを変更する処理ではありません。帳票、画面、通知文など、利用者に見せる箇所で使います。
元号名、年の表記、区切りなど、完成する文字列はシステムの設定や実行環境に依存し得ます。「令和元年」のような特定の文字列になることを前提に組み込まず、利用中の環境で実際の出力を確認してください。
ABAPでの呼び出し例
DATA: lv_date TYPE d VALUE '20240501',
lv_jp_date TYPE c LENGTH 20.
CALL FUNCTION 'CONVERSION_EXIT_JPDAT_OUTPUT'
EXPORTING
input = lv_date
IMPORTING
output = lv_jp_date.
" lv_jp_dateを帳票やメッセージの表示に使用する
lv_date は日付型、lv_jp_date は表示結果を受け取る文字型として用意します。出力先の長さは、帳票に必要な表記と実際の変換結果に合わせて決めてください。画面やフォームに組み込む前に、SE37でこの汎用モジュールを実行し、対象システムの入出力を確認すると確実です。
元号の切り替わりとCLJPを確認する
和暦変換は、システムに登録された元号情報に依存します。変換結果に想定した元号が出ない場合は、まずSAPの更新状況と日本の暦の設定を確認します。従来のSAPシステムではトランザクションコード CLJP で日本の暦を確認できます。元号が不足していても、運用環境に独自の設定をすぐ追加するのではなく、適用済みのSAP修正とシステム管理方針を先に確認してください。
特に元号が変わる日をまたぐ帳票では、境界日をテストします。平成から令和への切り替わりなら、少なくとも次の2日を確認対象にします。
20190430:平成として表示されること20190501:令和として表示されること
表記全体は帳票要件によって異なるため、「元年」か「01年」か、空白や区切り文字をどう表示するかも合わせて確認します。
実装時に気を付けたい3点
1. 変換前の日付を検証する
外部ファイルから取り込んだ値や文字型の日付を扱う場合は、変換前に日付として妥当か確認します。存在しない日付や初期値をそのまま渡して期待どおりの表示になると考えないようにします。検証方法はDATE_CHECK_PLAUSIBILITYで日付をチェックする記事も参照してください。
2. 保存・計算には西暦の日付を使う
和暦の結果は表示用の文字列です。日付の比較、月末日計算、データベース検索の条件などには、元のDATS値を使います。和暦文字列を業務データとして保存すると、元号や表示形式の変更に追従しづらくなります。
3. 帳票で文字化けや桁切れを確認する
プログラム上で値が正しくても、帳票の出力先で日本語フォントが使えなかったり、項目の幅が足りなかったりすると見た目が崩れます。フォーム、PDF、印刷物それぞれで確認し、受け取り項目と出力欄の幅を調整してください。
まとめ
CONVERSION_EXIT_JPDAT_OUTPUT は、SAP内部の日付を和暦表示に変えるときの選択肢です。日付の保存・計算は元の値で行い、表示するときに変換します。実装後は、SE37で出力形式を確かめ、元号の境界日と帳票の表示結果をテストしましょう。
参考・関連記事
- 汎用モジュール一覧:日付操作を含む標準モジュールを探すときに
- DATE_CHECK_PLAUSIBILITYで日付の妥当性を確認する:変換前の入力チェックに
- DAY_IN_WEEKで日付から曜日を取得する:帳票の日付表示を充実させるときに
- HR_JP_MONTH_BEGIN_END_DATEで月初日・月末日を取得する:対象期間の日付計算に