TIME スカラー関数

TIME 関数は、値から時刻を戻します。

Read syntax diagramSkip visual syntax diagramTIME(expression)

スキーマは SYSIBM です。

expression
以下のいずれかの組み込みデータ・タイプの値を戻す式。すなわち、DATE、TIME、TIMESTAMP、または日付、時刻、またはタイム・スタンプの有効な文字ストリング表記 (CLOB 以外)。 Unicode データベースでは、式によってグラフィック・ストリング・データ・タイプの値が戻る場合、値はまず文字ストリングに変換されてから、関数が実行されます。

関数の結果は TIME です。 引数が NULL になる可能性がある場合、結果も NULL になる可能性があります。 引数が NULL であれば、結果は NULL 値です。

その他の規則は、引数のデータ・タイプに応じて以下のように異なります。
  • 引数が DATE、または日付のストリング表記の場合
    • 結果は、夜の 12 時になります。
  • 引数が TIME の場合
    • 結果は、指定した時刻になります。
  • 引数が TIMESTAMP の場合
    • 結果はタイム・スタンプの時刻の部分になります。
  • 引数が時刻またはタイム・スタンプのストリング表記の場合
    • 結果は、そのストリングによって表される時刻になります。

例

IN_TRAY サンプル表から、 (任意の日の) 現在の時刻よりも 1 時間後以降に受け取ったすべての注を選択します。
   SELECT * FROM IN_TRAY
     WHERE TIME(RECEIVED) >= CURRENT TIME + 1 HOUR