共用方式為


PARSE (Transact-SQL)

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

傳回轉譯成 SQL Server 中所要求資料類型的運算式結果。

Transact-SQL 語法慣例

語法

PARSE ( string_value AS data_type [ USING culture ] )  

引數

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

string_value 必須是所要求之資料類型的有效表示法,否則 PARSE 會引發錯誤。

data_type
表示結果之資料類型的常值。

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

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

傳回型別

傳回轉譯成所要求之資料類型的運算式結果。

備註

以引數形式傳遞給 PARSE 的 Null 值,會以下列兩種方式處理:

  1. 如果傳遞了 NULL 常數就會引發錯誤。 Null 值無法以特定文化特定方式剖析為不同的資料類型。

  2. 如果在執行階段傳遞了 null 值的參數,將會傳回 null,以避免整個批次遭到取消。

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

PARSE 必須仰賴既存的 .NET Framework Common Language Runtime (CLR)。

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

data_type 參數的詳細資訊

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

類別 類型 .NET Framework 類型 使用的樣式
數值 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. 剖析為 datetime2

SELECT PARSE('Monday, 13 December 2010' AS datetime2 USING 'en-US') AS Result;  

結果集如下所示。

Result  
---------------  
2010-12-13 00:00:00.0000000  
  
(1 row(s) affected)  

B. 使用貨幣符號進行剖析

SELECT PARSE('€345,98' AS money USING 'de-DE') AS Result;  

結果集如下所示。

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

C. 使用語言的隱含設定進行剖析

-- The English language is mapped to en-US specific culture  
SET LANGUAGE 'English';  
SELECT PARSE('12/16/2010' AS datetime2) AS Result;  

結果集如下所示。

Result  
---------------  
2010-12-16 00:00:00.0000000  
  
(1 row(s) affected)