目次

Search

  1. はじめに
  2. トランスフォーメーション言語
  3. 定数
  4. 演算子
  5. 変数
  6. 日付
  7. 関数

トランスフォーメーション言語リファレンス

トランスフォーメーション言語リファレンス

TO_TIMESTAMP_TZ

TO_TIMESTAMP_TZ

文字列をTimestamp with Time Zone値に変換します。関数は、Timestamp with Time Zoneデータ型を返します。元の文字列のフォーマットを指定するには、TO_TIMESTAMP_TZフォーマット文字列を使用します。

構文

TO_TIMESTAMP_TZ (
String
, [
format
] )
以下の表に、このコマンドの引数を示します。
引数
必須/
オプション
説明
文字列
必須
Stringデータ型で指定する必要があります。Timestamp with Time Zone値に変換する値を渡します。有効なトランスフォーメーション式を必要に応じて入力できます。
文字列はすべて文字からなっていなければなりません。
形式
オプション
有効なTO_TIMESTAMP_TZフォーマット文字列を入力します。フォーマット文字列は、string引数の各部分と一致しなければなりません。例えば、'Mar 15 1997 12:43:10AM ASIA/CALCUTTA'の文字列を渡す場合、フォーマット文字列'MON DD YYYY HH12:MI:SSAM TZR'を使用する必要があります。
フォーマット文字列を指定しない場合は、[実行設定]ダイアログで指定したデフォルトの日時フォーマットが使用されます。

戻り値

timestamp with time zoneデータ型を返します。
NULL値を入力した場合は、NULLです。
関数に渡された値がtimestamp with time zoneの値として無効なデータを含んでいる場合、データ統合サービスはエラー行であることを示すマークをその行に付けるか、あるいはマッピングを中止します。
INPUT VALUE
RETURN VALUE
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’, 'YYYY-MM-DD HH:MI:SS.NS AM TZR'
次のデータについて、timestamp with time zoneデータ型を返します。
‘1947-08-05 10:45:00.221111000 AM AMERICA/LOS_ANGELES’
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’, 'YYYY-MM-DD HH:MI:SS.NS AM'
タイムゾーン地域フォーマットでタイムゾーン地域を指定しない場合でも、timestamp with time zoneデータ型を返します。
‘1947-08-05 10:45:00.221111000 AM AMERICA/LOS_ANGELES'
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’
タイムゾーンフォーマットでタイムスタンプを指定しない場合でも、timestamp with time zoneデータ型を返します。
'1947-08-05 10:45:00.221111000 AM AMERICA/LOS_ANGELES'
関数レベルでフォーマットを指定しない場合は、[実行設定]ダイアログのデフォルトの日付/時刻フォーマットが使用されます。
デフォルトの日付/時刻フォーマット:
'YYYY-MM-DD HH:MI:SS.NS AM TZR'
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’, ’MM-DD-YYYY HH:MI:SS.NS AM'
timestamp with time zoneデータが指定されたフォーマットと一致しない場合は、次のエラーが表示されます。
Process row failed for function [TO_TIMESTAMP_TZ]: Failed to convert the string to timestamp with time zone value. Verify that the specified date format string is valid. Verify that the timestamp with time zone string used in the first argument is compatible with the specified date format.