%TIME (時刻への変換)

%TIME{(expression{:time-format})}

%TIME は式の値を文字、数字、またはタイム・スタンプのデータから、時刻タイプに変換します。 変換後の値は変更されないままですが、時刻として戻されます。

最初のパラメーターは、変換される対象の値です。値を指定しない場合、%TIME は現行システム時刻を戻します。

2 番目のパラメーターは、数値または文字の入力データの時刻の形式です。 入力データの形式にかかわらず、出力は *ISO 形式で戻されます。

使用できる入力データの形式については、時刻データ・タイプを参照してください。 数値または文字の入力データの場合に時刻の形式が指定されていない場合、デフォルト値は制御仕様書の TIMFMT キーワードに指定された形式または *ISO のいずれかになります。詳細については、TIMFMT(形式{区切り記号})を参照してください。

最初のパラメーターがタイム・スタンプの場合は、2 番目のパラメーターは指定してはなりません。 システムは、この場合の入力データの形式については理解しています。

詳細については、情報命令または 組み込み関数を参照してください。

図 234. %TIME の例
  *..1....+....2....+....3....+....4....+....5....+....6....+....7...+....
  /FREE

    string = '12:34 PM';
    time =  %time(string:*USA);
    // time = t'12.34.00'
  /END-FREE