PARSE(Transact-SQL)
적용 대상: 
SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance 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는 SQL Server에서 명시적으로 지원하는 언어로만 국한되지 않으며 .NET Framework에서 지원하는 모든 culture를 수용합니다. culture 인수가 유효하지 않을 경우 PARSE는 오류를 발생시킵니다.
반환 형식
요청한 데이터 형식으로 변환된 식 결과를 반환합니다.
설명
PARSE에 인수로 전달된 Null 값은 두 가지 방법으로 처리됩니다.
Null 상수를 전달하는 경우 오류가 발생합니다. Null 값은 culture를 인식하는 방법으로 다른 데이터 형식으로 구문 분석될 수 없습니다.
런타임에 Null 값이 포함된 매개 변수를 전달할 경우 Null이 반환되며 전체 일괄 처리가 취소되지 않습니다.
PARSE는 문자열에서 날짜/시간 및 숫자 형식으로 변환하는 경우에만 사용하세요. 일반 형식 변환의 경우 이전처럼 CAST나 CONVERT를 사용합니다. 문자열 값을 구문 분석할 경우 성능에 영향을 주게 됩니다.
PARSE는 .NET Framework CLR(공용 언어 런타임)이 설치되어 있어야 사용할 수 있습니다.
이 함수는 CLR이 있어야 실행되므로 원격에서 실행할 수 없습니다. CLR이 설치되어 있어야만 실행되는 함수를 원격에서 호출할 경우 원격 서버에서 오류가 발생합니다.
data_type 매개 변수에 대한 자세한 정보
data_type 매개 변수의 값은 다음 표에 나온 형식 및 스타일로 제한됩니다. 허용되는 패턴을 쉽게 알 수 있도록 스타일 정보가 나와 있습니다. 스타일에 대한 자세한 내용은 System.Globalization.NumberStyles 및 DateTimeStyles 열거형에 대한 .NET Framework 설명서를 참조하십시오.
| Category | Type | .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 culture 간 매핑을 보여 줍니다.
| 전체 이름 | Alias | LCID | 해당 culture |
|---|---|---|---|
| us_english | 영어 | 1033 | ko-KR |
| 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(브라질) | 브라질어 | 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. 통화 기호를 포함하는 PARSE
SELECT PARSE('€345,98' AS money USING 'de-DE') AS Result;
결과 집합은 다음과 같습니다.
Result
---------------
345.98
(1 row(s) affected)
C. 언어의 암시적 설정을 포함하는 PARSE
-- 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)