PARSE (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Ponto de extremidade de análises SQL no Microsoft Fabric Warehouse no Microsoft Fabric

Retorna o resultado de uma expressão, convertida no tipo de dados solicitado no SQL Server.

Convenções de sintaxe de Transact-SQL

Sintaxe

PARSE ( string_value AS data_type [ USING culture ] )  

Argumentos

string_value
Valor nvarchar(4000) que representa o valor formatado a ser analisado no tipo de dados especificado.

string_value deve ser uma representação válida do tipo de dados solicitado, ou PARSE gera um erro.

data_type
Valor literal que representa o tipo de dados solicitado para o resultado.

cultura
Cadeia de caracteres opcional que identifica a cultura na qual string_value é formatado.

Se o argumento culture não for fornecido, o idioma da sessão atual será usado. Esse idioma é definido implícita ou explicitamente com o uso da instrução SET LANGUAGE. culture aceita qualquer cultura compatível com o .NET Framework; não se limita aos idiomas explicitamente compatíveis do SQL Server. Se o argumento culture não for válido, PARSE gerará um erro.

Tipos de retorno

Retorna o resultado da expressão, convertida no tipo de dados solicitado.

Comentários

Os valores nulos transmitidos como argumentos para PARSE são tratados de dois modos:

1. Se uma constante nula for transmitida, um erro ocorrerá. Um valor nulo não pode ser analisado em um tipo de dados diferente de maneira cultural.

2. Se um parâmetro com um valor nulo for transmitido no momento da execução, um valor nulo será retornado, para evitar o cancelamento do lote inteiro.

Use PARSE somente para converter de cadeia de caracteres em data/hora e tipos numéricos. Para conversões de tipos gerais, continue a usar CAST ou CONVERT. Lembre-se de que há uma certa sobrecarga de desempenho na análise do valor da cadeia de caracteres.

PARSE depende da presença do CLR (Common Language Runtime) do .NET Framework.

Essa função não será remota uma vez que ela depende da presença do CLR. Uma função remota que exige o CLR provocará um erro no servidor remoto.

Mais informações sobre o parâmetro data_type

Os valores para o parâmetro data_type serão restritos aos tipos mostrados na tabela a seguir, juntamente com estilos. As informações de estilo são fornecidas para ajudar a determinar que tipos de padrões são permitidos. Para obter mais informações sobre estilos, veja a documentação do .NET Framework para as enumerações System.Globalization.NumberStyles e DateTimeStyles.

Mais informações sobre o parâmetro culture

A tabela a seguir mostra os mapeamentos de idiomas do SQL Server para culturas do .NET Framework.

Exemplos

a. PARSE em datetime2

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

Veja a seguir o conjunto de resultados.

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

B. PARSE com símbolo de moeda

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

Veja a seguir o conjunto de resultados.

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

C. PARSE com configuração implícita de idioma

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

Veja a seguir o conjunto de resultados.

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