日付命令

日付命令を次の表に示します。

日付命令により、日付フィールド、時刻フィールド、およびタイム・スタンプ・フィールド、さらには日付、時刻、タイム・スタンプを表す文字フィールドあるいは数字フィールドを処理することができます。 以下を行うことができます。

• 年、月、日、時間、分、秒、あるいはマイクロ秒の単位での期間の加算または減算
• 2 つの日付、時刻、またはタイム・スタンプの間の期間の判別
• 日付、時刻、またはタイム・スタンプの値からの抽出 (例えば、日)
• 日付、時刻、またはタイム・スタンプの値が有効かどうかのテスト

期間を加算または減算するには、自由形式構文では + 演算子または - 演算子を使用でき、従来型の構文では ADDDUR 命令コードまたは SUBDUR 命令コードを使用できます。 下記の表では、自由形式構文で使用する組み込み関数と、従来型の構文で使用する期間コードを示します。

例えば、次のどちらの方法でも、既存の日付に 23 日を加算することができます。

C                   ADDDUR    23:*D         DUEDATE

 /FREE
     newdate = duedate + %DAYS(23)
 /END-FREE

2 つの日付、時刻、またはタイム・スタンプの間の期間を計算するには、自由形式構文では %DIFF 組み込み関数を使用でき、従来型の構文では SUBDUR 命令コードを使用できます。どちらの場合にも、表 65 に示す期間コードのいずれかを指定する必要があります。

期間は完全な単位として渡され、剰余は廃棄されます。 59 分という期間は、時間単位で表せば 0 になります。61 分という期間は、時間単位で表せば 1 になります。

次の表では、SUBDUR 命令コードを使用した追加の例を示します。%DIFF 組み込み関数でも同じ結果を得られます。