SECOND

SECOND 関数は、値の秒の部分と、オプションで小数秒を戻します。


                          .-,--0------------------.      
>>-SECOND--(--expression--+-----------------------+--)---------><
                          '-,--precision-constant-'

expression

日付、時刻、タイム・スタンプ、文字ストリング、グラフィック・ストリング、または数値のいずれかの組み込みデータ・タイプの値を戻す式。

式が文字ストリングまたはグラフィック・ストリングである場合、その値は、日時値の有効なストリング表現でなければなりません。式がタイム・スタンプの有効なストリング表現である場合、まず最初に TIMESTAMP(12) 値に変換されます。式が日付の有効なストリング表現の場合、その形式は IBM® SQL 標準形式のいずれかでなければなりません。日時値のストリング表現の有効な形式については、日付/時刻の値のストリング表記を参照してください。
引数が DATE である場合、時刻が午前 0 時ちょうど (00.00.00) であると想定して、最初に TIMESTAMP(0) 値に変換されます。
式が数値である場合は、その数値は時刻期間またはタイム・スタンプ期間でなければなりません。日時期間の有効な形式については、日付/時刻のオペランドと期間を参照してください。

precision-constant

小数秒の桁数を表す整数定数。値の範囲は 0 から 12 です。

引数が 1 つの場合のこの関数の結果は、長精度整数です。引数が 2 つの場合のこの関数の結果は、DECIMAL(2+s,s) です。ここで、s は precision-constant の値です。引数が NULL になる可能性がある場合は、結果も NULL になる可能性があります。引数が NULL の場合は、結果は NULL 値になります。

その他の規則は、引数のデータ・タイプに応じて以下のように異なります。

引数が日付、時刻、またはタイム・スタンプであるか、または、日付、時刻、またはタイム・スタンプの有効な文字ストリングである場合:
引数が 1 つだけ指定されている場合、結果は値の秒の部分 (0 から 59) になります。

両方の引数が指定されている場合、結果は、値の秒の部分 (0 から 59) と、桁数が precision-constant の小数秒の部分とになります。値に小数秒がない場合、ゼロが戻されます。
引数が時刻期間またはタイム・スタンプ期間の場合 :
引数が 1 つだけ指定されている場合、結果は値の秒の部分 (-99 から 99) になります。ゼロ以外の結果の符号は、引数と同じになります。

両方の引数が指定されている場合、結果は、値の秒の部分 (-99 から 99) と、桁数が precision-constant の小数秒の部分とになります。値に小数秒がない場合、ゼロが戻されます。ゼロ以外の結果の符号は、引数と同じになります。

例

ホスト変数 TIME_DUR (DECIMAL(6,0)) は、値が 153045 であると想定します。
```
  SELECT SECOND(:TIME_DUR)
    FROM SYSIBM.SYSDUMMY1
```
値として 45 が戻されます。
列 RECEIVED (TIMESTAMP) には、1988-12-25-17.12.30.000000 に相当する内部値が入っているものと想定します。
```
  SELECT SECOND(RECEIVED)
    FROM IN_TRAY
```
値として 30 が戻されます。
ミリ秒単位の現在のタイム・スタンプから、小数秒を持つ秒を取得します。
```
  SELECT SECOND(CURRENT TIMESTAMP(3),3)
    FROM SYSIBM.SYSDUMMY1
```
現在のタイム・スタンプ (54.321 など) に基づいて DECIMAL(5,3) 値を戻します。