CAST e CONVERT (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsEndpoint de análise SQL no Microsoft FabricArmazém no Microsoft FabricBanco de dados SQL no Microsoft Fabric

Essas funções convertem uma expressão de um tipo de dados em outro.

Sintaxe

Sintaxe CAST:

CAST ( expression AS data_type [ ( length ) ] )

Sintaxe CONVERT:

CONVERT ( data_type [ ( length ) ] , expression [ , style ] )

Convenções de sintaxe de Transact-SQL

Argumentos

expressão

Qualquer expression válida.

data_type

O tipo de dados de destino. Isso inclui xml, bigint, e sql_variant. Não é possível usar tipos de dados de alias.

comprimento

Um inteiro opcional que especifica o tamanho do tipo de dados de destino, para tipos de dados que permitem um comprimento especificado do usuário. O valor padrão é 30.

estilo

Uma expressão inteira que especifica como a CONVERT função traduz a expressão. Para um valor de estilo de NULL, NULL é retornado. data_type determina o intervalo.

Tipos de retorno

Retorna a expression convertida em data_type.

Estilos de data e hora

Para uma expression de tipo de dados de data ou hora, style pode ter um dos valores mostrados na tabela a seguir. Outros valores são processados como 0. A partir do SQL Server 2012 (11.x), os únicos estilos suportados, ao converter de tipos de data e hora para datetimeoffset, são 0 ou 1. Todos os outros estilos de conversão retornam erro 9809.

¹ Esses valores de estilo retornam resultados não determinísticos. Inclui todos os estilos (yy) (sem século) e um subconjunto de estilos (yyyy) (com século).

² Os valores padrão (0 ou 100, 9 ou 109, 13 ou 113, ou 120, 20 , 23ou 2125 ou 121) sempre retornam o século (yyyy).

³ Entrada quando é feita a conversão em datetime; saída quando é feita a conversão em dados de caractere.

⁴ Criado para uso do XML. Para a conversão de datetime ou smalldatetime em dados de caractere, veja o formato de saída na tabela anterior.

⁵ Islâmico é um sistema de calendário com diversas variações. O Mecanismo de Banco de Dados utiliza o algoritmo kuwaitiano.

⁶ Para um valor de milissegundos (fff) igual a 0, o valor da fração decimal de milissegundo não será exibido. Por exemplo, o valor 2022-11-07T18:26:20.000 será exibido como 2022-11-07T18:26:20.

⁷ Nesse estilo, MMMM representa uma representação Hijri Unicode de vários tokens do nome do mês completo. Esse valor não é renderizado corretamente em uma instalação padrão do SSMS em inglês dos EUA.

⁸ Compatível apenas na conversão de dados de caractere em datetime ou smalldatetime. Ao converter dados de caractere que representam componentes apenas de data ou apenas de hora em tipos de dados datetime ou smalldatetime, o componente de hora não especificado é definido como 00:00:00.000 e o componente de data não especificado é definido como 1900-01-01.

⁹ Use o indicador Z opcional de fuso horário para facilitar o mapeamento de valores data-horários XML que contêm informações de fuso horário para valores de data-hora do Mecanismo de Banco de Dados que não têm fuso horário. Z indica o fuso horário em UTC-0. O deslocamento de HH:mm, na direção + ou -, indica outros fusos horários. Por exemplo: 2022-12-12T23:45:12-08:00.

Ao converter smalldatetime em dados de caractere, os estilos que incluem segundos ou milissegundos mostram zeros nessas posições. Ao converter de valores datetime ou smalldatetime, use um tamanho de tipo de dados char ou varchar apropriado para truncar as partes de data indesejadas.

Ao converter dados de caractere em datetimeoffset, usando um estilo que inclui uma hora, um deslocamento de fuso horário é acrescentado ao resultado.

Estilos float e real

Para uma expression de float ou real, style pode ter um dos valores mostrados na tabela a seguir. Outros valores são processados como 0.

Estilos money e smallmoney

Para uma expression de money ou smallmoney, style pode ter um dos valores mostrados na tabela a seguir. Outros valores são processados como 0.

Estilos xml

Para uma expressionxml, style pode ter um dos valores mostrados na tabela a seguir. Outros valores são processados como 0.

Estilos binários

Para uma expressão binary(n), char(n), varbinary(n) ou varchar(n),style pode ter um dos valores mostrados na tabela a seguir. Valores de estilo não listados na tabela retornam um erro.

Conversões implícitas

Conversões implícitas não exigem a especificação da função CAST nem da função CONVERT. Conversões explícitas exigem a especificação da função CAST ou da função CONVERT. A ilustração a seguir mostra todas as conversões explícitas e implícitas de tipos de dados permitidas para os tipos de dados fornecidos pelo Mecanismo de Banco de Dados do sistema. Esses incluem bigint, sql_variant, xml, hierarchyid, geography, geometry, json e vector. Os tipos de dados json e vector estão disponíveis apenas no SQL Server 2025 (17.x), Banco de Dados SQL do Azure, Instância Gerenciada de SQL do Azure e SQL Database no Microsoft Fabric. Não há conversão implícita na atribuição a partir do tipo de dado sql_variant , mas há conversão implícita para sql_variant.

O gráfico acima ilustra todas as conversões explícitas e implícitas que são permitidas no Mecanismo de Banco de Dados, mas o tipo de dado resultante da conversão depende da operação que está sendo realizada:

• Para conversões explícitas, a própria instrução determina o tipo de dados resultante.
• Para conversões implícitas, instruções de atribuição como definir o valor de uma variável ou inserir um valor em uma coluna resultam no tipo de dados que foi definido pela declaração de variável ou definição de coluna.
• Para operadores de comparação ou outras expressões, o tipo de dados resultante depende das regras de precedência de tipo de dados.

Para alguns tipos de dados, o resultado depende de como o tipo de dado é declarado:

• Decimal e numérico: O Mecanismo de Banco de Dados trata cada combinação de precisão e escala como um tipo de dado diferente. A conversão entre eles pode ser implícita. Um valor com mais casas decimais do que a escala alvo é arredondado sem erro. Um valor que é grande demais para a precisão alvo causa o erro 8115, a menos que ARITHABORT e sejam ambos OFF; então o resultado é NULLANSI_WARNINGS .
• Você não pode converter varchar(max),nvarchar(max) e varbinary(max) para sql_variant.
• Conversão entre diferentes tipos de CLR definidos pelo usuário não é permitida.
• A conversão implícita é suportada entre xml não tipado e xml tipado, e entre valores de xml tipado que usam a mesma coleção de esquemas XML e o mesmo DOCUMENT ou CONTENT facet.
• A conversão entre diferentes coleções de esquemas XML, ou entre diferentes DOCUMENT facetas e CONTENT distintos, deve ser explícita. Conversão entre um tipo CLR definido pelo usuário e um xml tipado não é permitida.
• A conversão entre valores vetoriais é permitida apenas quando as dimensões e o tipo base (float32 ou float16) são iguais.

Uma conversão que o gráfico mostra como permitida ainda pode falhar para um valor específico, por exemplo, uma string que não é JSON válida, ou um vetor com um número diferente de dimensões. Os valores dos tipos de dados imagem, ntext, text, xml, geografia, geometria, json e vetorial não podem ser comparados com o operador igual a (=), mesmo quando ambos os valores têm o mesmo tipo de dado.

Ao converter entre datetimeoffset e os tipos de caractere char, nchar, nvarchar e varchar, a parte do deslocamento de fuso horário convertido sempre deve ter dois dígitos para HH e mm. Por exemplo, -08:00.

Os tipos de dados nchar e nvarchar armazenam dados Unicode na codificação UTF-16, que sempre usa um número par de bytes. Tenha cuidado ao converter binário ou varbinário para ou de nchar ou nvarchar. Por exemplo, a conversão seguinte não retorna um valor hexadecimal de 41. Ele retorna um valor hexadecimal de 4100:

SELECT CAST (CAST (0x41 AS NVARCHAR) AS VARBINARY);

Para obter mais informações, consulte Suporte para ordenação e Unicode.

Tipos de dados de valor grande

Tipos de dados de valor grande têm o mesmo comportamento de conversão implícita e explícita de seus equivalentes menores, escpecificamente, os tipos de dados varchar, nvarchar e varbinary. No entanto, considere as seguintes diretrizes:

• A conversão de image em varbinary(max) e vice-versa opera como uma conversão implícita, assim como as conversões entre text e varchar(max) e ntext e nvarchar(max) .
• A conversão de tipos de dados de valor grande, como varchar(max) , em um tipo de dados equivalente menor, como varchar, é uma conversão implícita, mas ocorrerá um truncamento se o tamanho do valor grande exceder o tamanho especificado do tipo de dados menor.
• A conversão de nvarchar, varbinary ou varchar em seus tipos de dados de valor grande correspondentes ocorre implicitamente.
• A conversão de tipo de dados sql_variant em tipos de dados de valor grande é uma conversão explícita.
• Tipos de dados de valor grande não podem ser convertidos no tipo de dados sql_variant.

Para mais informações sobre conversão a partir do tipo de dado xml , veja Criar instâncias de dados XML.

tipo de dados xml

Ao converter o tipo de dados xml explícita ou implicitamente em um tipo de dados de cadeia de caracteres ou binários, o conteúdo do tipo de dados xml é serializado de acordo com um conjunto de regras definido. Para informações sobre essas regras, veja Definir a serialização de dados XML. Para informações sobre conversão de outros tipos de dados para o tipo de dado xml , veja Criar instâncias de dados XML.

Tipos de dados text e image

Os tipos de dados text e image não dão suporte à conversão automática de tipo de dados. Você pode converter explicitamente os dados text em dados de caractere, e os dados image em binary ou varbinary, mas o tamanho máximo é de 8.000 bytes. Se você tentar uma conversão incorreta, por exemplo, tentar converter uma expressão de caractere que inclui letras para um int, o Mecanismo de Banco de Dados retorna uma mensagem de erro.

Ordenação de saída

Quando as funções CAST ou CONVERT produzem uma cadeia de caracteres e elas recebem uma entrada de cadeia de caracteres, a saída tem a mesma ordenação e o mesmo rótulo de ordenação que a entrada. Se a entrada não for uma cadeia de caracteres, a saída terá a ordenação padrão do banco de dados e um rótulo de ordenação de padrão coercível. Para obter mais informações, confira a Precedência de ordenação.

Para atribuir uma colação diferente à saída, aplique a COLLATE cláusula à expressão de resultado da CAST função ou CONVERT . Por exemplo:

SELECT CAST ('abc' AS VARCHAR (5)) COLLATE French_CS_AS;

Truncando e arredondando resultados

Ao converter expressões de caractere ou binárias (binary, char, nchar, nvarchar, varbinary ou varchar) em uma expressão de um tipo de dados diferente, a operação de conversão pode truncar os dados de saída, apenas parcialmente exibir os dados de saída ou retornar um erro. Esses casos ocorrem se o resultado for curto demais para ser exibido. As conversões em binary, char, nchar, nvarchar, varbinary ou varchar são truncadas, com exceção das conversões mostradas na tabela a seguir.

¹ Erro retornado porque o comprimento do resultado é muito curto para ser exibido.

O Mecanismo de Banco de Dados do SQL Server garante que apenas conversões de ida e volta, ou seja, conversões que convertem um tipo de dado do seu tipo original e viceversa, geram os mesmos valores de versão para versão. O exemplo a seguir mostra essa conversão de ida e volta:

DECLARE @myval AS DECIMAL (5, 2);
SET @myval = 193.57;

SELECT CAST (CAST (@myval AS VARBINARY (20)) AS DECIMAL (10, 5));

-- Or, using CONVERT
SELECT CONVERT (DECIMAL (10, 5), CONVERT (VARBINARY (20), @myval));
GO

O exemplo a seguir mostra uma expressão resultante que é muito pequena para ser exibida.

USE AdventureWorks2025;
GO

SELECT p.FirstName,
       p.LastName,
       SUBSTRING(p.Title, 1, 25) AS Title,
       CAST (e.SickLeaveHours AS CHAR (1)) AS [Sick Leave]
FROM HumanResources.Employee AS e
     INNER JOIN Person.Person AS p
         ON e.BusinessEntityID = p.BusinessEntityID
WHERE NOT e.BusinessEntityID > 5;
GO

Veja a seguir o conjunto de resultados.

FirstName   LastName      Title   Sick Leave
---------   ------------- ------- --------`
Ken         Sanchez       NULL   *
Terri       Duffy         NULL   *
Roberto     Tamburello    NULL   *
Rob         Walters       NULL   *
Gail        Erickson      Ms.    *

Quando você converte tipos de dados que diferem em casas decimais, o Mecanismo de Banco de Dados às vezes retorna um valor de resultado truncado, e em outras ocasiões retorna um valor arredondado. Esta tabela mostra o comportamento.

¹ A conversão de valores float que usam notação científica para decimal ou numeric é restrita apenas a valores de precisão de 17 dígitos. Qualquer valor com precisão mais alto que 17 rodadas para zero.

Por exemplo, os valores 10.6496 e -10.6496 podem ser truncados ou arredondados durante a conversão para tipos int ou numéricos :

SELECT CAST (10.6496 AS INT) AS trunc1,
       CAST (-10.6496 AS INT) AS trunc2,
       CAST (10.6496 AS NUMERIC) AS round1,
       CAST (-10.6496 AS NUMERIC) AS round2;

Os resultados da consulta são mostrados na seguinte tabela:

Ao converter tipos de dados em que o tipo de dados de destino tem menos casas decimais do que o tipo de dados de origem, o valor é arredondado. Por exemplo, esta conversão retorna $10.3497:

SELECT CAST (10.3496847 AS MONEY);

O Mecanismo de Banco de Dados retorna uma mensagem de erro ao converter dados não numéricos de char, nchar, nvarchar ou varchar para decimal, float, int, numérico. O Mecanismo de Banco de Dados também retorna um erro quando uma string vazia ( ) é convertida em numérico ou decimal.

Algumas conversões de datetime não são determinísticas

Os estilos para os quais a conversão de cadeia de caracteres em datetime é não determinística são os seguintes:

• Todos os estilos abaixo 100 de ¹
• 106
• 107
• 109
• 113
• 130

¹ Com exceção dos estilos 20 e 21

Para obter mais informações, confira Conversão não determinística de cadeias de caracteres de data literal em valores de DATA.

Caracteres suplementares (pares alternativos)

Desde o SQL Server 2012 (11.x), ao usar ordenações de SC (caracteres suplementares), uma operação CAST de nchar ou nvarchar para um tipo nchar ou nvarchar de tamanho menor não será truncada em um par alternativo. Em vez disso, a operação é truncada antes do caractere suplementar. Por exemplo, o fragmento de código a seguir deixa @x que contém só ab. Não há espaço suficiente para conter o caractere suplementar.

DECLARE @x AS NVARCHAR (10) = 'ab' + NCHAR(0x10000);

SELECT CAST (@x AS NVARCHAR (3));

Ao usar ordenações SC, o comportamento de CONVERT é análogo ao comportamento de CAST. Para saber mais, confira Suporte a ordenações e a Unicode – caracteres suplementares.

Suporte de compatibilidade

Em versões anteriores do SQL Server, o estilo padrão para CAST e CONVERT operações nos tipos de dados time e datetime2 é 121, exceto quando qualquer um dos tipos é usado em uma expressão de coluna computada. Para colunas computadas, o estilo padrão é 0. Esse comportamento afeta colunas computadas quando são criadas, usadas em consultas envolvendo autoparametrização ou em definições de restrições.

Sob nível 110de compatibilidade e superiores, as CAST operações e CONVERT nos tipos de dados time e datetime2 sempre têm 121 como estilo padrão. Se uma consulta se basear no comportamento antigo, use um nível de compatibilidade menor que 110, ou especifique explicitamente o 0 estilo na consulta afetada.

¹ Exceto para colunas computadas

Atualizar o banco de dados para nível 110 de compatibilidade ou superior não vai alterar os dados do usuário que foram armazenados no disco. Você deve corrigir esses dados manualmente conforme apropriado. Por exemplo, se você usasse SELECT INTO para criar uma tabela a partir de uma fonte contendo uma expressão de coluna computada descrita acima, os dados (usando o estilo 0) seriam armazenados em vez da própria definição computada da coluna. Você deve atualizar manualmente esses dados para combinar com o estilo 121.

Exemplos

Os exemplos de código neste artigo usam o AdventureWorks2025, AdventureWorksDW2025, ou AdventureWorksLT2025 banco de dados de exemplo, que você pode baixar do repositório GitHub do Azure Data SQL Samples Repository.

a. Usar CAST e CONVERT

Estes exemplos recuperam o nome dos produtos que têm um 3 no primeiro dígito de seu preço de lista e converte seus valores ListPrice em int.

Uso CAST:

USE AdventureWorks2025;
GO

SELECT SUBSTRING(Name, 1, 30) AS ProductName,
       ListPrice
FROM Production.Product
WHERE CAST (ListPrice AS INT) LIKE '33%';
GO

Uso CONVERT:

USE AdventureWorks2025;
GO

SELECT SUBSTRING(Name, 1, 30) AS ProductName,
       ListPrice
FROM Production.Product
WHERE CONVERT (INT, ListPrice) LIKE '33%';
GO

Veja a seguir o conjunto de resultados. O conjunto de resultados de exemplo é o mesmo para CAST e CONVERT.

ProductName                    ListPrice
------------------------------ ---------------------
LL Road Frame - Black, 58      337.22
LL Road Frame - Black, 60      337.22
LL Road Frame - Black, 62      337.22
LL Road Frame - Red, 44        337.22
LL Road Frame - Red, 48        337.22
LL Road Frame - Red, 52        337.22
LL Road Frame - Red, 58        337.22
LL Road Frame - Red, 60        337.22
LL Road Frame - Red, 62        337.22
LL Road Frame - Black, 44      337.22
LL Road Frame - Black, 48      337.22
LL Road Frame - Black, 52      337.22
Mountain-100 Black, 38         3374.99
Mountain-100 Black, 42         3374.99
Mountain-100 Black, 44         3374.99
Mountain-100 Black, 48         3374.99
HL Road Front Wheel            330.06
LL Touring Frame - Yellow, 62  333.42
LL Touring Frame - Blue, 50    333.42
LL Touring Frame - Blue, 54    333.42
LL Touring Frame - Blue, 58    333.42
LL Touring Frame - Blue, 62    333.42
LL Touring Frame - Yellow, 44  333.42
LL Touring Frame - Yellow, 50  333.42
LL Touring Frame - Yellow, 54  333.42
LL Touring Frame - Yellow, 58  333.42
LL Touring Frame - Blue, 44    333.42
HL Road Tire                   32.60

B. Usar CAST com operadores aritméticos

Este exemplo calcula uma computação de coluna única (Computed) dividindo as vendas totais acumuladas no ano (SalesYTD) pelo percentual de comissão (CommissionPCT). Esse valor é arredondado para o próximo número inteiro e, em seguida, é CAST em um tipo de dados int.

USE AdventureWorks2025;
GO

SELECT CAST (ROUND(SalesYTD / CommissionPCT, 0) AS INT) AS Computed
FROM Sales.SalesPerson
WHERE CommissionPCT != 0;
GO

Veja a seguir o conjunto de resultados.

Computed
------
379753754
346698349
257144242
176493899
281101272
0
301872549
212623750
298948202
250784119
239246890
101664220
124511336
97688107

C. Usar CAST para concatenação

Este exemplo concatena expressões sem caracteres usando CAST. Ele usa o banco de dados AdventureWorksDW2025.

SELECT 'The list price is ' + CAST (ListPrice AS VARCHAR (12)) AS ListPrice
FROM dbo.DimProduct
WHERE ListPrice BETWEEN 350.00 AND 400.00;

Veja a seguir o conjunto de resultados.

ListPrice
------------------------
The list price is 357.06
The list price is 364.09
The list price is 364.09
The list price is 364.09
The list price is 364.09

D. Usar CAST para produzir textos mais legíveis

Este exemplo é usado CAST na SELECT lista para converter a Name coluna em uma coluna char(10). Ele usa o banco de dados AdventureWorksDW2025.

SELECT DISTINCT CAST (EnglishProductName AS CHAR (10)) AS Name,
                ListPrice
FROM dbo.DimProduct
WHERE EnglishProductName LIKE 'Long-Sleeve Logo Jersey, M';
GO

Veja a seguir o conjunto de resultados.

Name        ListPrice
----------  ---------
Long-Sleev  31.2437
Long-Sleev  32.4935
Long-Sleev  49.99

E. Usar CAST com a cláusula LIKE

Este exemplo converte os valores money da coluna SalesYTD no tipo de dados int e, em seguida, no tipo de dados char(20), de modo que a cláusula LIKE possa usá-los.

USE AdventureWorks2025;
GO

SELECT p.FirstName,
       p.LastName,
       s.SalesYTD,
       s.BusinessEntityID
FROM Person.Person AS p
     INNER JOIN Sales.SalesPerson AS s
         ON p.BusinessEntityID = s.BusinessEntityID
WHERE CAST (CAST (s.SalesYTD AS INT) AS CHAR (20)) LIKE '2%';
GO

Veja a seguir o conjunto de resultados.

FirstName        LastName            SalesYTD         BusinessEntityID
---------------- ------------------- ---------------- -------------
Tsvi             Reiter              2811012.7151      279
Syed             Abbas               219088.8836       288
Rachel           Valdez              2241204.0424      289

F. Usar CONVERT ou CAST com XML tipado

Esses exemplos mostram o uso de CONVERT para converter dados em XML tipado, utilizando o tipo de dado e as colunas XML (SQL Server).

Este exemplo converte uma cadeia de caracteres com espaço em branco, texto e marcação em XML tipado e remove todos os espaços em branco insignificantes (espaço em branco delimitador entre nós):

SELECT CONVERT (XML, '<root><child/></root>');

Este exemplo converte uma cadeia de caracteres semelhante com espaço em branco, texto e marcação em XML com tipo e preserva todos os espaços em branco insignificantes (espaço em branco delimitador entre nós):

SELECT CONVERT (XML, '<root>          <child/>         </root>', 1);

Este exemplo converte uma cadeia de caracteres com espaço branco, texto e marcação em XML com tipo:

SELECT CAST ('<Name><FName>Carol</FName><LName>Elliot</LName></Name>' AS XML);

Veja Criar instâncias de dados XML para mais exemplos.

G. Usar CAST e CONVERT com dados datetime

Começando com valores GETDATE(), este exemplo exibe a data e hora atual, usa CAST para alterar a data e hora atual para um tipo de dados de caractere e, em seguida, usa CONVERT para exibir a data e hora no formato ISO 8601.

SELECT GETDATE() AS UnconvertedDateTime,
       CAST (GETDATE() AS NVARCHAR (30)) AS UsingCast,
       CONVERT (NVARCHAR (30), GETDATE(), 126) AS UsingConvertTo_ISO8601;
GO

Veja a seguir o conjunto de resultados.

UnconvertedDateTime     UsingCast              UsingConvertTo_ISO8601
----------------------- ---------------------- ------------------------------
2022-04-18 09:58:04.570 Apr 18 2022  9:58AM    2022-04-18T09:58:04.570

Este exemplo é aproximadamente o oposto do exemplo anterior. Este exemplo exibe data e hora como dados de caracteres, usa CAST para alterar esses dados de caractere para o tipo de dados datetime e, em seguida, usa CONVERT para alterá-los para o tipo de dados datetime.

SELECT '2006-04-25T15:50:59.997' AS UnconvertedText,
       CAST ('2006-04-25T15:50:59.997' AS DATETIME) AS UsingCast,
       CONVERT (DATETIME, '2006-04-25T15:50:59.997', 126) AS UsingConvertFrom_ISO8601;
GO

Veja a seguir o conjunto de resultados.

UnconvertedText         UsingCast               UsingConvertFrom_ISO8601
----------------------- ----------------------- ------------------------
2006-04-25T15:50:59.997 2006-04-25 15:50:59.997 2006-04-25 15:50:59.997

H. Usar CONVERT com dados binários e de caractere

Estes exemplos mostram os resultados da conversão de dados binários e de caractere usando estilos diferentes.

--Convert the binary value 0x4E616d65 to a character value.
SELECT CONVERT (CHAR (8), 0x4E616d65, 0) AS [Style 0, binary to character];

Veja a seguir o conjunto de resultados.

Style 0, binary to character
----------------------------
Name

Este exemplo mostra que o Style 1 pode forçar truncamento do resultado. Os caracteres 0x no conjunto de resultados forçam a truncação.

SELECT CONVERT (CHAR (8), 0x4E616d65, 1) AS [Style 1, binary to character];

Veja a seguir o conjunto de resultados.

Style 1, binary to character
------------------------------
0x4E616D

Este exemplo mostra que Style 2 não trunca o resultado, porque o resultado não inclui os caracteres 0x.

SELECT CONVERT (CHAR (8), 0x4E616d65, 2) AS [Style 2, binary to character];

Veja a seguir o conjunto de resultados.

Style 2, binary to character
------------------------------
4E616D65

Converta o valor Name do caractere em um valor binário.

SELECT CONVERT (BINARY (8), 'Name', 0) AS [Style 0, character to binary];

Veja a seguir o conjunto de resultados.

Style 0, character to binary
----------------------------
0x4E616D6500000000

SELECT CONVERT (BINARY (4), '0x4E616D65', 1) AS [Style 1, character to binary];

Veja a seguir o conjunto de resultados.

Style 1, character to binary
----------------------------
0x4E616D65

SELECT CONVERT (BINARY (4), '4E616D65', 2) AS [Style 2, character to binary];

Veja a seguir o conjunto de resultados.

Style 2, character to binary
----------------------------------
0x4E616D65

Eu. Converter os tipos de dados de data e hora

Este exemplo mostra a conversão dos tipos de dados date, time e datetime.

DECLARE @d1 AS DATE,
        @t1 AS TIME,
        @dt1 AS DATETIME;

SET @d1 = GETDATE();
SET @t1 = GETDATE();
SET @dt1 = GETDATE();
SET @d1 = GETDATE();

-- When converting date to datetime the minutes portion becomes zero.
SELECT @d1 AS DATE,
       CAST (@d1 AS DATETIME) AS [date as datetime];

-- When converting time to datetime the date portion becomes zero
-- which converts to January 1, 1900.
SELECT @t1 AS TIME,
       CAST (@t1 AS DATETIME) AS [time as datetime];

-- When converting datetime to date or time non-applicable portion is dropped.
SELECT @dt1 AS DATETIME,
       CAST (@dt1 AS DATE) AS [datetime as date],
       CAST (@dt1 AS TIME) AS [datetime as time];

Verifique se os valores estão em um intervalo compatível ao considerar uma conversão de date para datetime ou datetime2. O valor mínimo de ano para datetime é 1753, e o valor mínimo de ano para 0001 e datetime2 é .

DECLARE @d1 AS DATE,
        @dt1 AS DATETIME,
        @dt2 AS DATETIME2;

SET @d1 = '1492-08-03';
--This is okay; Minimum YYYY for DATE is 0001

SET @dt2 = CAST (@d1 AS DATETIME2);
--This is okay; Minimum YYYY for DATETIME2 IS 0001

SET @dt1 = CAST (@d1 AS DATETIME);
--This returns an error with (Msg 242) "The conversion of a date data type to a datetime data type resulted in an out-of-range value."
--Minimum YYYY for DATETIME is 1753

J. Usar CONVERT com dados datetime em diferentes formatos

Começando com valores GETDATE(), este exemplo usa CONVERT para exibir todos os estilos de data e hora na seção Estilos de data e hora deste artigo.

K. Efeitos da precedência de tipo de dados em conversões permitidas

O exemplo a seguir define uma variável do tipo varchar(10), atribui um valor inteiro a ela e seleciona uma concatenação da variável com uma cadeia de caracteres.

DECLARE @string AS VARCHAR (10);
SET @string = 1;

SELECT @string + ' is a string.' AS Result;

Veja a seguir o conjunto de resultados.

Result
-----------------------
1 is a string.

O valor de 1 de int foi convertido em um varchar.

O seguinte exemplo mostra uma consulta semelhante, que usa uma variável int como alternativa:

DECLARE @notastring AS INT;
SET @notastring = '1';

SELECT @notastring + ' is not a string.' AS Result;

Nesse caso, a instrução SELECT gera o seguinte erro:

Msg 245, Level 16, State 1, Line 3
Conversion failed when converting the varchar value ' is not a string.' to data type int.

Para avaliar a expressão @notastring + ' is not a string.', o Mecanismo de Banco de Dados precisa seguir as regras de precedência de tipo de dado para completar a conversão implícita antes que o resultado da expressão possa ser calculado. Como int tem precedência maior que varchar, o Mecanismo de Banco de Dados tenta converter a string em inteiro e falha porque essa string não pode ser convertida em inteiro.

Se fornecermos uma string que pode ser convertida, a afirmação tem sucesso, como visto no exemplo a seguir:

DECLARE @notastring AS INT;
SET @notastring = '1';

SELECT @notastring + '1';

Nesse caso, a cadeia de caracteres '1' pode ser convertida para o valor inteiro 1, de modo que essa instrução SELECT retorna o valor 2. Quando os tipos de dados fornecidos são inteiros, o + operador torna-se operador matemático de adição, em vez de uma concatenação de strings.

Exemplos: Azure Synapse Analytics

L. Usar CAST e CONVERT

Este exemplo recupera o nome dos produtos que têm um 3 no primeiro dígito de seu preço de lista e converte o ListPrice desses produtos em int. Ele usa o banco de dados AdventureWorksDW2025.

SELECT EnglishProductName AS ProductName,
       ListPrice
FROM dbo.DimProduct
WHERE CAST (ListPrice AS INT) LIKE '3%';

Este exemplo mostra a mesma consulta, usando CONVERT em vez de CAST. Ele usa o banco de dados AdventureWorksDW2025.

SELECT EnglishProductName AS ProductName,
       ListPrice
FROM dbo.DimProduct
WHERE CONVERT (INT, ListPrice) LIKE '3%';

M. Usar CAST com operadores aritméticos

Este exemplo faz um cálculo de um valor de coluna única, dividindo o preço unitário do produto (UnitPrice) pelo percentual de desconto (UnitPriceDiscountPct). Em seguida, esse resultado é arredondado para o número inteiro mais próximo e, por fim, é convertido em um tipo de dados int. Este exemplo usa o banco de dados AdventureWorksDW2025.

SELECT ProductKey,
       UnitPrice,
       UnitPriceDiscountPct,
       CAST (ROUND(UnitPrice * UnitPriceDiscountPct, 0) AS INT) AS DiscountPrice
FROM dbo.FactResellerSales
WHERE SalesOrderNumber = 'SO47355'
      AND UnitPriceDiscountPct > .02;

Veja a seguir o conjunto de resultados.

ProductKey  UnitPrice  UnitPriceDiscountPct  DiscountPrice
----------  ---------  --------------------  -------------
323         430.6445   0.05                  22
213         18.5043    0.05                  1
456         37.4950    0.10                  4
456         37.4950    0.10                  4
216         18.5043    0.05                  1

N. Usar CAST com a cláusula LIKE

Este exemplo converte a colunaListPrice do dinheiro para um tipo int , e depois para um tipo char(20 ), para que a LIKE cláusula possa usá-la. Este exemplo usa o banco de dados AdventureWorksDW2025.

SELECT EnglishProductName AS Name,
       ListPrice
FROM dbo.DimProduct
WHERE CAST (CAST (ListPrice AS INT) AS CHAR (20)) LIKE '2%';

O. Usar CAST e CONVERT com dados datetime

Este exemplo exibe a data e a hora atuais, usa CAST para alterá-las para um tipo de dados de caractere e, por fim, usa CONVERT para exibir a data e a hora no formato ISO 8601. Este exemplo usa o banco de dados AdventureWorksDW2025.

SELECT TOP (1) SYSDATETIME() AS UnconvertedDateTime,
               CAST (SYSDATETIME() AS NVARCHAR (30)) AS UsingCast,
               CONVERT (NVARCHAR (30), SYSDATETIME(), 126) AS UsingConvertTo_ISO8601
FROM dbo.DimCustomer;

Veja a seguir o conjunto de resultados.

UnconvertedDateTime     UsingCast                     UsingConvertTo_ISO8601
---------------------   ---------------------------   ---------------------------
07/20/2010 1:44:31 PM   2010-07-20 13:44:31.5879025   2010-07-20T13:44:31.5879025

Este exemplo é o oposto aproximado do exemplo anterior. Este exemplo exibe data e hora como dados de caracteres, usa CAST para alterar esses dados de caractere para o tipo de dados datetime e, em seguida, usa CONVERT para alterá-los para o tipo de dados datetime. Este exemplo usa o banco de dados AdventureWorksDW2025.

SELECT TOP (1) '2010-07-25T13:50:38.544' AS UnconvertedText,
               CAST ('2010-07-25T13:50:38.544' AS DATETIME) AS UsingCast,
               CONVERT (DATETIME, '2010-07-25T13:50:38.544', 126) AS UsingConvertFrom_ISO8601
FROM dbo.DimCustomer;

Veja a seguir o conjunto de resultados.

UnconvertedText         UsingCast               UsingConvertFrom_ISO8601
----------------------- ----------------------- ------------------------
2010-07-25T13:50:38.544 07/25/2010 1:50:38 PM   07/25/2010 1:50:38 PM

Conteúdo relacionado

• FORMATO (Transact-SQL)
• FOR (Transact-SQL)
• SELECT (Transact-SQL)
• Funções do sistema por categoria para Transact-SQL
• Suporte à ordenação e Unicode
• Precedência de tipo de dados (Transact-SQL)
• Conversão de tipo de dados (Mecanismo de Banco de Dados)
• Gravar instruções Transact-SQL internacionais