%TIME (時刻への変換)

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

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

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

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

使用できる入力形式について詳しくは、 Time Data Typeを参照してください。 数値または文字の入力データの時刻形式が指定されなかった場合、デフォルト形式は *ISO です。 詳しくは、 TIMFMT (fmt{separator})を参照してください。

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

詳しくは、 情報操作 または 組み込み関数を参照してください。

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

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