MIDNIGHT_SECONDS スカラー関数

午前 0 時から引数で指定した時刻値までの秒数を表す 0 から 86 400 の範囲の整数値を戻します。

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

スキーマは SYSFUN です。

expression
以下のいずれかの組み込みデータ・タイプの値を戻す式。すなわち、DATE、TIME、TIMESTAMP、または日付、時刻、またはタイム・スタンプの有効な文字ストリング表記 (CLOB 以外)。式が DATE または日付の有効なストリング表記である場合、時刻が午前 0 時ちょうど (00.00.00) であると想定して、最初に TIMESTAMP(0) 値に変換されます。Unicode データベースでは、指定した引数が GRAPHIC ストリングであると、 まず文字ストリングに変換されてから、関数が実行されます。

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

  • 例 1: 午前 0 時から 00:10:10 までの秒数、 および午前 0 時から 13:10:10 までの秒数を求めます。
       VALUES (MIDNIGHT_SECONDS('00:10:10'), MIDNIGHT_SECONDS('13:10:10'))
    この例では、以下を戻します。
    1           2
    ----------- -----------
            610       47410

    1 分は 60 秒なので、午前 0 時から指定された時刻までは 610 秒です。2 番目の例でも同じです。1 時間は 3600 秒であり、1 分は 60 秒なので、指定された時刻から午前 0 時までは 47 410 秒です。

  • 例 2: 午前 0 時から 24:00:00 までの秒数、および午前 0 時から 00:00:00 までの秒数を求めます。
       VALUES (MIDNIGHT_SECONDS('24:00:00'), MIDNIGHT_SECONDS('00:00:00'))
    この例では、以下を戻します。
    1           2
    ----------- -----------
          86400           0

    これらの 2 つの値は、同じポイント・イン・タイムを表しているにもかかわらず、 MIDNIGHT_SECONDS 値が異なっていることに注意してください。