HOUR スカラー関数

HOUR 関数は、値の時の部分を戻します。

構文図を読む構文図をスキップするHOUR(expression)

スキーマは SYSIBM です。

expression
組み込みデータ・タイプ (DATE、TIME、TIMESTAMP、文字ストリング、または完全な数値データ・タイプ) のいずれかの値を戻す式。

expression が文字ストリングである場合、CLOB にしてはなりません。また、その値は、日時値の有効なストリング表記でなければなりません。日付/時刻の値の ストリング表記の有効なフォーマットについては、『日付/時刻の値』の『日付/時刻の値のストリング 表記』を参照してください。

expression が完全な数値の場合は、時刻期間またはタイム・スタンプ期間でなければなりません。有効な時刻期間とタイム・スタンプ期間に関する情報は、『日時オペランドおよび期間』を参照してください。

Unicode データベースだけが、DBCLOB でない日時値の有効な GRAPHIC ストリング表現である式をサポートします。まず GRAPHIC ストリングが文字ストリングに変換されてから、関数が実行されます。

この関数の結果は長精度整数 (large integer) です。 引数が NULL になる可能性がある場合、結果も NULL になる可能性があります。 引数が NULL であれば、結果は NULL 値です。

その他の規則は、引数のデータ・タイプに応じて以下のように異なります。
  • 引数が、TIME、TIMESTAMP、 あるいは時刻またはタイム・スタンプの有効なストリング表記の場合
    • 結果は、値の時間の部分 (0 から 24 の整数) になります。
  • 引数が DATE、または日付の有効なストリング表記の場合
    • 結果は、0 になります。
  • 引数が時刻期間またはタイム・スタンプ期間の場合
    • 結果は、値の時の部分 (-99 から 99 の整数) になります。 ゼロ以外の結果の符号は、引数と同じになります。

例

CL_SCHED サンプル表を使用して、午後に始まるすべてのクラスを選択します。 
   SELECT * FROM CL_SCHED
     WHERE HOUR(STARTING) BETWEEN 12 AND 17