TIMESTAM

TIMESTAMP 函數會從其引數傳回時間戳記。

讀取語法圖跳過視覺化語法圖TIMESTAMP(expression-1 ,expression-2精準度常數 )
expression-1expression-2

引數的規則取決於是否指定第二個引數,以及第二個引數的資料類型。

  • 如果只指定 expression-1 :
    引數必須是傳回下列其中一種內建資料類型的值的表示式: a date、 時間戳記、字串或圖形字串。 如果 expression-1 是字元或圖形字串,則其值必須是下列其中一項:
    • 日期或 時間戳記的有效字串表示法。 如需 日期和 時間戳記之字串表示法的有效格式,請參閱 日期時間值的字串表示法
    • 實際長度為 13 的字串,假設是 GENERATE_UNIQUE 函數的結果。 如需 GENERATE_UNIQUE 的相關資訊,請參閱 GENERATE_UNIQUE
  • 如果同時指定兩個引數:
    • 如果第二個引數是 expression-2:

      第一個引數必須是傳回下列其中一個內建資料類型的值的表示式: 日期、字串或圖形字串。 如果 expression-1 是字元或圖形字串,則其值必須是有效的日期字串表示法。

      expression-2 必須是傳回下列其中一個內建資料類型的值的表示式: 時間、字串或圖形字串。 如果 expression-2 是字元或圖形字串,則其值必須是時間的有效字串表示法。 如需日期和時間的有效字串表示法格式,請參閱 日期時間值的字串表示法

    • 如果第二個引數是 precision-constant:
      第一個引數必須是傳回下列其中一個內建資料類型的值的表示式: 日期、時間戳記、字串或圖形字串。 如果 expression-1 是字元或圖形字串,則其值必須是下列其中一項:
      • 日期或 時間戳記的有效字串表示法。 如需日期和時間戳記之字串表示法的有效格式,請參閱 日期時間值的字串表示法
      • 實際長度為 13 的字串,假設是 GENERATE_UNIQUE 函數的結果。 如需 GENERATE_UNIQUE 的相關資訊,請參閱 GENERATE_UNIQUE
精準度-常數
代表小數秒數的整數常數。 值必須在 0 到 12 的範圍內。

函數的結果是時間戳記。 如果任一引數可以是空值,則結果可以是空值; 如果任一引數是空值,則結果是空值。

其他規則取決於是否指定第二個引數:

  • 如果兩個引數都指定 ,且第二個引數是 expression-2:

    結果是 TIMESTAMP (6) ,其日期由第一個引數指定,時間由第二個引數指定。 時間戳記的 小數秒 部分是零。

  • 如果同時指定兩個引數,且第二個引數是 precision-constant:

    結果是具有第二個引數所指定精準度的時間戳記。

  • 如果只指定一個引數,且它是 TIMESTAMP (p):

    結果是 TIMESTAMP (p)

  • 如果只指定一個引數,且它是 DATE:

    結果是假設時間午夜強制轉型為 TIMESTAMP (0) 的日期。

  • 如果只指定一個引數,且它是字串:

    結果是該字串所代表的 TIMESTAMP (6) 。 如果引數是長度為 14 的字串,則時間戳記具有零的小數秒部分。

附註

替代語法: 當只指定一個引數時,應該使用 CAST 規格來增加應用程式的可攜性。 如需相關資訊,請參閱 CAST 規格

範例

  • 假設下列日期和時間值:
      SELECT TIMESTAMP( DATE('1988-12-25'), TIME('17.12.30') )
        FROM SYSIBM.SYSDUMMY1
    傳回值 '1988-12-25-17.12.30.000000'。
  • 將具有 7 位數小數秒的時間戳記字串轉換為 TIMESTAMP (9) 值。
    TIMESTAMP('2007-09-24-15.53.37.2162474', 9)
    傳回值 '2007-09-24-15.53.37.216247400'。