MICROSECOND
MICROSECOND 関数は、値のマイクロ秒の部分を戻します。
- expression
- 日付、時刻、タイム・スタンプ、文字ストリング、
グラフィック・ストリング、または数値のいずれかの組み込みデータ・タイプの値を戻す式。
- expression が文字ストリングまたはグラフィック・ストリングである場合、 その値は、日時値の有効なストリング表現でなければなりません。式が 日付の有効なストリング表現の場合、その形式は IBM® SQL 標準形式のいずれかでなければなりません。日付とタイム・スタンプのストリング表現の有効な形式に ついては、日付/時刻の値のストリング表記を参照してください。
- 引数が DATE である場合、時刻が午前 0 時ちょうど (00.00.00) であると想定して、最初に TIMESTAMP(0) 値に変換されます。
- expression が数値の場合、この数値はタイム・スタンプ期間であることが必要です。日時期間の有効な形式については、日付/時刻のオペランドと期間を参照してください。
この関数の結果は長精度整数になります。 引数が NULL になる可能性がある場合は、結果も NULL になる可能性があります。 引数が NULL の場合は、結果は NULL 値になります。
その他の規則は、引数のデータ・タイプに応じて以下のように異なります。
- 引数が日付、時刻、またはタイム・スタンプであるか、
日付、時刻、またはタイム・スタンプの有効な文字ストリング表現である場合:
結果は、0 から 999999 までの整数です。
タイム・スタンプの精度が 6 を超える場合、値は切り捨てられます。
- 引数が期間の場合 :
結果は、値のマイクロ秒の部分 (-999999 から 999999 までの整数) になります。 ゼロ以外の結果の符号は、引数と同じになります。
例
- 表 TABLEA に、タイプが TIMESTAMP の TS1 および TS2 という 2 つの列が入っているものとします。
TS1 のマイクロ秒部分がゼロではなく、
TS1 と TS2 の秒部分が同じである行すべてを選択します。
SELECT * FROM TABLEA WHERE MICROSECOND(TS1) <> 0 AND SECOND(TS1) = SECOND(TS2)