TIMESTAMP スカラー関数

スキーマは SYSIBM です。

Unicode データベースだけが、 日付、時刻、またはタイム・スタンプの GRAPHIC ストリング表現である引数をサポートします。 Unicode データベースでは、指定した引数が GRAPHIC ストリングであると、 まず文字ストリングに変換されてから、関数が実行されます。

expression1 および expression2

引数に関する規則は、expression2 が指定されているかどうか、および expression2 のデータ・タイプによって異なります。

• 引数が 1 つのみ指定されている場合は、組み込みデータ・タイプ (DATE か TIMESTAMP、または CLOB ではない文字ストリング) のいずれかの値を戻す式でなければなりません。 expression1 が文字ストリングの場合は、以下のいずれかでなければなりません。
  • 日付またはタイム・スタンプの有効な文字ストリング表記。 日付またはタイム・スタンプの値のストリング表記の有効なフォーマットについては、『日付/時刻の値』の『日付/時刻の値のストリング表記』を参照してください。
  • GENERATE_UNIQUE 関数からの結果と想定される、実際の長さが 13 の文字ストリング。
  • 長さ 14 のストリング。これは、有効な日付と時刻を yyyyxxddhhmmss という形式で表した数字のストリングです (ここで、yyyy は年、xx は月、dd は日、hh は時、mm は分、そして ss は秒を表します)
• expression1 および expression2 が指定されている場合は、次のようになります。
  • expression2 のデータ・タイプが整数でない場合:
    • expression1 は DATE または日付の有効なストリング表現でなければならず、expression2 は TIME または時刻の有効なストリング表現でなければなりません。
  • expression2 のデータ・タイプが整数の場合:
    • expression1 は DATE、TIMESTAMP、またはタイム・スタンプや日付の有効なストリング表記でなければなりません。 expression2 は、タイム・スタンプ精度を表す 0 から 12 までの範囲の整数定数でなければなりません。

関数の結果は TIMESTAMP です。

引数が日付情報のみを含む場合、結果の値の時刻情報はすべてゼロになります。 引数のいずれかが NULL 値になる可能性がある場合、 結果も NULL 値になる可能性があります。 引数のいずれかが NULL 値の場合、その結果は NULL 値です。