TRY_CAST (Transact-SQL)

  • 發行項

適用於：Microsoft Fabric 中 Microsoft Fabric倉儲中的 SQL ServerAzure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse AnalyticsAnalytics Platform System （PDW）SQL 分析端點

如果轉換成功，則會傳回轉換為指定之資料類型的值，否則會傳回 Null。

Transact-SQL 語法慣例

Syntax

TRY_CAST ( expression AS data_type [ ( length ) ] )

注意

若要檢視 SQL Server 2014 （12.x） 和舊版的 Transact-SQL 語法，請參閱 舊版檔。

引數

expression

指定要轉換的任何有效運算式。

data_type

運算式轉換成的資料類型。

length

指定目標資料類型之長度的選擇性整數。

可接受值的範圍由 data_type 值決定。

傳回類型

如果轉換成功，則會傳回轉換為指定之資料類型的值，否則會傳回 Null。

備註

TRY_CAST 會取得傳遞給它的值，並嘗試將它轉換成指定的 data_type。 如果轉換成功， TRY_CAST 則會傳回值做為指定的 data_type;如果發生錯誤，則會傳回 null。 不過，如果您要求明確不允許的轉換，則 TRY_CAST 失敗並出現錯誤。

TRY_CAST 不是新的保留關鍵詞，而且適用於所有相容性層級。 TRY_CAST 具有與 TRY_CONVERT 連線到遠端伺服器時相同的語意。

TRY_CAST 如果長度超過 8000，則不適用於 varchar（max ）。

範例

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/2022' 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/2022' AS DATETIME2) AS Result;
GO

以下為結果集。

Result
----------------------------------
2022-12-31 00:00:00.0000000
  
(1 row(s) affected)

另請參閱