TIMESTAM
TIMESTAMP 函數會從其引數傳回時間戳記。
- expression-1 和 expression-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。
- 如果第二個引數是 expression-2:
- 如果只指定 expression-1 :
- 精準度-常數
- 代表小數秒數的整數常數。 值必須在 0 到 12 的範圍內。
函數的結果是時間戳記。 如果任一引數可以是空值,則結果可以是空值; 如果任一引數是空值,則結果是空值。
其他規則取決於是否指定第二個引數:
- 如果兩個引數都指定 ,且第二個引數是 expression-2:
結果是 TIMESTAMP (6) ,其日期由第一個引數指定,時間由第二個引數指定。 時間戳記的 小數秒 部分是零。
- 如果同時指定兩個引數,且第二個引數是 precision-constant:
結果是具有第二個引數所指定精準度的時間戳記。
- 如果只指定一個引數,且它是 TIMESTAMP (p):
結果是 TIMESTAMP (p)。
- 如果只指定一個引數,且它是 DATE:
結果是假設時間午夜強制轉型為 TIMESTAMP (0) 的日期。
- 如果只指定一個引數,且它是字串:
結果是該字串所代表的 TIMESTAMP (6) 。 如果引數是長度為 14 的字串,則時間戳記具有零的小數秒部分。
附註
替代語法: 當只指定一個引數時,應該使用 CAST 規格來增加應用程式的可攜性。 如需相關資訊,請參閱 CAST 規格。
範例
- 假設下列日期和時間值:
傳回值 '1988-12-25-17.12.30.000000'。SELECT TIMESTAMP( DATE('1988-12-25'), TIME('17.12.30') ) FROM SYSIBM.SYSDUMMY1
- 將具有 7 位數小數秒的時間戳記字串轉換為 TIMESTAMP (9) 值。
傳回值 '2007-09-24-15.53.37.216247400'。TIMESTAMP('2007-09-24-15.53.37.2162474', 9)
