カテゴリ:

変換関数

TRY_TO_TIMESTAMP / TRY_TO_TIMESTAMP_*

同じ操作を実行する(入力式をタイムスタンプに変換する)が、エラー処理がサポートされている TO_TIMESTAMP / TO_TIMESTAMP_* の特別バージョンです(つまり、変換を実行できない場合、エラーを発生させる代わりに NULL 値を返します)。

詳細については、 エラー処理変換関数 をご参照ください。

注釈

TRY_TO_TIMESTAMP TIMESTAMP_TYPE_MAPPING セッションパラメータに基づいて、他のタイムスタンプ関数の1つにマッピングします。パラメータのデフォルトは TIMESTAMP_NTZ であるため、 TRY_TO_TIMESTAMP はデフォルトで TRY_TO_TIMESTAMP_NTZ にマッピングされます。

構文

timestampFunction ( <string_expr> [, <format> ] )

条件:

timestampFunction ::=
    TRY_TO_TIMESTAMP | TRY_TO_TIMESTAMP_LTZ | TRY_TO_TIMESTAMP_NTZ | TRY_TO_TIMESTAMP_TZ

引数

必須:

文字列式

引数は、 TIMESTAMP (TIMESTAMP_NTZ、 TIMESTAMP_LTZ、または TIMESTAMP_TZ)に評価できる文字列でなければなりません。

オプション:

形式

文字列式 または AUTO のフォーマット指定子。詳細については、 変換関数の日付と時刻の形式 をご参照ください。

デフォルトは、 TIMESTAMP_INPUT_FORMAT セッションパラメーターの現在の値です(通常は AUTO)。

戻り値

返される値のデータ型は、 TIMESTAMP データ型のいずれかです。デフォルトでは、データ型は TIMESTAMP_NTZ です。これを変更するには、セッションパラメーター TIMESTAMP_TYPE_MAPPING を設定します。

使用上の注意

  • 文字列式でのみ機能します。

これは TRY_TO_TIMESTAMP の使用方法を示しています。

SELECT TRY_TO_TIMESTAMP('2018-09-15 12:30:00'), TRY_TO_TIMESTAMP('Invalid');
+-----------------------------------------+-----------------------------+
| TRY_TO_TIMESTAMP('2018-09-15 12:30:00') | TRY_TO_TIMESTAMP('INVALID') |
|-----------------------------------------+-----------------------------|
| 2018-09-15 12:30:00.000                 | NULL                        |
+-----------------------------------------+-----------------------------+