キャストが成功した場合は、指定したデータ型にキャストされた値を返します。それ以外の場合は null を返します。
.gif "トピック リンク アイコン")
構文
TRY_CAST ( expression AS data_type [ ( length ) ] )
引数
- expression
キャストされる値。 任意の有効な式。
data_type
expression をキャストするデータ型。length
対象のデータ型の長さを指定する整数 (省略可能)。許容される値の範囲は、data_type の値によって決まります。
戻り値の型
キャストが成功した場合は、指定したデータ型にキャストされた値を返します。それ以外の場合は null を返します。
説明
TRY_CAST は渡された値を取得し、指定された data_type への変換を試みます。 キャストが成功した場合、TRY_CAST は指定した data_type と同じ値を返します。エラーが発生した場合は null が返されます。 ただし、明示的に許可されない変換を要求すると、TRY_CAST はエラーが発生して失敗します。
TRY_CAST は予約された新しいキーワードではなく、すべての互換レベルで使用可能です。 TRY_CAST がリモート サーバーに接続するときのセマンティクスは、TRY_CONVERT と同じです。
使用例
A. TRY_CAST は null を返します。
次の例では、キャストに失敗すると TRY_CAST は null を返します。
SELECT
CASE WHEN TRY_CAST('test' AS float) IS NULL
THEN 'Cast failed'
ELSE 'Cast succeeded'
END AS Result;
GO
以下に結果セットを示します。
Result
------------
Cast failed
(1 row(s) affected)
次の例は、特定の形式の式が必要であることを示しています。
SET DATEFORMAT dmy;
SELECT TRY_CAST('12/31/2010' AS datetime2) AS Result;
GO
以下に結果セットを示します。
Result
----------------------
NULL
(1 row(s) affected)
B. TRY_CAST はエラーが発生して失敗します。
次の例では、キャストが明示的に許可されていない場合に TRY_CAST はエラーを返します。
SELECT TRY_CAST(4 AS xml) AS Result;
GO
このステートメントの結果はエラーです。整数を xml データ型にキャストすることはできないからです。
Explicit conversion from data type int to xml is not allowed.
C. TRY_CAST は成功します。
次の例は、特定の形式の式が必要であることを示しています。
SET DATEFORMAT mdy;
SELECT TRY_CAST('12/31/2010' AS datetime2) AS Result;
GO
以下に結果セットを示します。
Result
----------------------------------
2010-12-31 00:00:00.0000000
(1 row(s) affected)