TRY_PARSE (Transact-SQL)

  • 發行項

適用于： Microsoft Fabric 中 Microsoft Fabric 倉儲中的 Sql Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics SQL 分析端點

將會傳回運算式的結果，並轉譯為所要求的資料類型。若在 SQL Server 中轉換失敗，則傳回 Null。 TRY_PARSE 僅適用於從字串轉換到日期/時間及數字類型。

Transact-SQL 語法慣例

Syntax

TRY_PARSE ( string_value AS data_type [ USING culture ] )

注意

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

引數

string_value
nvarchar(4000) 值，代表要剖析為指定資料類型的格式化值。

string_value 必須是所要求之資料類型的有效表示法，否則 TRY_PARSE 會傳回 null。

data_type
以文字表示結果所要求的資料類型。

culture
選擇性字串，指出 string_value 要據以格式化的文化特性 (Culture)。

如未提供 culture 引數，將會使用目前工作階段的語言。 此語言是以 SET LANGUAGE 陳述式隱含或明確加以設定。 文化特性接受 .NET Framework 所支援的任何文化特性，不限於 SQL Server 明確支援的語言。 如果 culture 引數無效，PARSE 會引發錯誤。

傳回型別

將傳回運算式結果，並轉譯為所要求的資料類型；若轉換失敗，則傳回 Null。

備註

TRY_PARSE 僅適用於從字串轉換到日期/時間及數字類型。 一般類型轉換仍可繼續使用 CAST 或 CONVERT。 請注意，剖析字串值將對效能造成一定程度的負擔。

TRY_PARSE 仰賴既存的 .NET Framework Common Language Runtime (CLR)。

因為必須要有 CLR 才可執行此函數，所以無法從遠端進行。 從遠端處理需要 CLR 的函數，會導致遠端伺服器發生錯誤。

data_type 參數的詳細資訊

date_type 的參數值僅適用於下表所示的類型與樣式。 此處所提供的樣式資訊可以協助您決定所要允許的模式類型。 如需樣式的詳細資訊，請參閱說明 System.Globalization.NumberStyles 和 DateTimeStyles 列舉的 .NET Framework 文件。

類別 類型 .NET 類型 使用的樣式
數值 BIGINT Int64 NumberStyles.Number
數值 int Int32 NumberStyles.Number
數值 SMALLINT Int16 NumberStyles.Number
數值 TINYINT Byte NumberStyles.Number
數值 decimal Decimal NumberStyles.Number
數值 NUMERIC Decimal NumberStyles.Number
數值 FLOAT Double NumberStyles.Float
數值 real Single NumberStyles.Float
數值 SMALLMONEY Decimal NumberStyles.Currency
數值 money Decimal NumberStyles.Currency
日期及時間 date Datetime DateTimeStyles.AllowWhiteSpaces | DateTimeStyles.AssumeUniversal
日期及時間 time TimeSpan DateTimeStyles.AllowWhiteSpaces | DateTimeStyles.AssumeUniversal
日期及時間 Datetime Datetime DateTimeStyles.AllowWhiteSpaces | DateTimeStyles.AssumeUniversal
日期及時間 smalldatetime Datetime DateTimeStyles.AllowWhiteSpaces | DateTimeStyles.AssumeUniversal
日期及時間 datetime2 Datetime DateTimeStyles.AllowWhiteSpaces | DateTimeStyles.AssumeUniversal
日期及時間 datetimeoffset DateTimeOffset DateTimeStyles.AllowWhiteSpaces | DateTimeStyles.AssumeUniversal

文化特性 (Culture) 參數的詳細資訊

下表顯示 SQL Server 語言對應的 .NET Framework 文化特性。

全名 Alias LCID 專屬文化特性
us_english 英文 1033 en-US
Deutsch 德文 1031 de-DE
Français 法文 1036 fr-FR
日本語 日文 1041 ja-JP
Dansk 丹麥文 1030 da-DK
Español 西班牙文 3082 es-ES
Italiano 義大利文 1040 it-IT
Nederlands 荷蘭文 1043 nl-NL
Norsk 挪威文 2068 nn-NO
Português 葡萄牙文 2070 pt-PT
Suomi 芬蘭文 1035 fi-FI
Svenska 瑞典文 1053 sv-SE
čeština 捷克文 1029 Cs-CZ
magyar 匈牙利文 1038 Hu-HU
polski 波蘭文 1045 Pl-PL
română 羅馬尼亞文 1048 Ro-RO
hrvatski 克羅埃西亞文 1050 hr-HR
slovenčina 斯洛伐克文 1051 Sk-SK
slovenski 斯洛維尼亞文 1060 Sl-SI
ελληνικά 希臘文 1032 El-GR
български 保加利亞文 1026 bg-BG
русский 俄文 1049 Ru-RU
Türkçe 土耳其文 1055 Tr-TR
British 英式英文 2057 en-GB
eesti 愛沙尼亞文 1061 Et-EE
latviešu 拉脫維亞文 1062 lv-LV
lietuvių 立陶宛文 1063 lt-LT
Português (Brasil) 巴西文 1046 pt-BR
繁體中文 繁體中文 1028 zh-TW
한국어 韓文 1042 Ko-KR
简体中文 簡體中文 2052 zh-CN
阿拉伯文 阿拉伯文 1025 ar-SA
ไทย 泰文 1054 Th-TH

範例

A. TRY_PARSE 的簡單範例

SELECT TRY_PARSE('Jabberwokkie' AS datetime2 USING 'en-US') AS Result;

以下為結果集。

Result  
---------------  
NULL  
  
(1 row(s) affected)

B. 使用 TRY_PARSE 偵測 Null

SELECT  
    CASE WHEN TRY_PARSE('Aragorn' AS decimal USING 'sr-Latn-CS') IS NULL  
        THEN 'True'  
        ELSE 'False'  
END  
AS Result;

以下為結果集。

Result  
---------------  
True  
  
(1 row(s) affected)

C. 一併使用 IIF 與 TRY_PARSE 及隱含文化特性設定

SET LANGUAGE English;  
SELECT IIF(TRY_PARSE('01/01/2011' AS datetime2) IS NULL, 'True', 'False') AS Result;

以下為結果集。

Result  
---------------  
False  
  
(1 row(s) affected)

另請參閱

PARSE (Transact-SQL)
轉換函數 (Transact-SQL)
TRY_CONVERT (Transact-SQL)
CAST 和 CONVERT (Transact-SQL)