PARSE (Transact-SQL)
適用於：
SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Microsoft Fabric 中的 SQL 分析端點 Microsoft Fabric 中的倉儲
傳回轉譯成 SQL Server 中所要求資料類型的運算式結果。
語法
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 值，會以下列兩種方式處理：
如果傳遞了 NULL 常數就會引發錯誤。 Null 值無法以特定文化特定方式剖析為不同的資料類型。
如果在執行階段傳遞了 null 值的參數，將會傳回 null，以避免整個批次遭到取消。
PARSE 僅適用於從字串轉換到日期/時間及數字類型。 一般類型轉換仍可繼續使用 CAST 或 CONVERT。 請注意，剖析字串值將對效能造成一定程度的負擔。
PARSE 必須仰賴既存的 .NET Framework Common Language Runtime (CLR)。
因為必須要有 CLR 才可執行此函數，所以無法從遠端進行。 從遠端處理需要 CLR 的函數，會導致遠端伺服器發生錯誤。
data_type 參數的詳細資訊
date_type 的參數值僅適用於下表所示的類型與樣式。 此處所提供的樣式資訊可以協助您決定所要允許的模式類型。 如需樣式的詳細資訊，請參閱說明 System.Globalization.NumberStyles 和 DateTimeStyles 列舉的 .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)