Função CONVERT

Assim como aFunção CAST, a função CONVERT converte um tipo de dados em outro tipo de dados compatível. Por exemplo, é possível converter uma string em uma data ou um tipo numérico em uma string. CONVERT executa uma conversão em runtime, o que significa que a conversão não altera o tipo de dado de um valor em uma tabela de origem. Isso é alterado somente no contexto da consulta.

Determinados tipos de dados exigem uma conversão explícita para outros tipos de dados usando a função CONVERT. Outros tipos de dados podem ser convertidos implicitamente, como parte de outro comando, sem usar CAST ou CONVERT. Consulte Compatibilidade e conversão dos tipos.

Sintaxe

CONVERT ( type, expression )

Argumentos

tipo

Um dos tipos de dados suportadosTipos de dados, exceto para os tipos de dados VARBYTE, BINARY e BINARY VARYING.

expressão

Uma expressão que avalia para um ou mais valores, tal como um nome de coluna ou um literal. A conversão de valores nulos retorna nulos. A expressão não pode conter cadeias de caracteres em branco ou vazias.

Tipo de retorno

CONVERT retorna o tipo de dados especificado pelo argumento type.

nota

AWS Clean Rooms retorna um erro se você tentar realizar uma conversão problemática, como uma conversão DECIMAL que perde a precisão, como a seguir:

SELECT CONVERT(decimal(2,1), 123.456);

ou uma conversão INTEGER que causa um transbordamento:

SELECT CONVERT(smallint, 12345678);

Exemplos

A consulta a seguir usa a função CONVERT para converter uma coluna de números decimais em inteiros.

SELECT CONVERT(integer, pricepaid)
FROM sales WHERE salesid=100;

Este exemplo converte um número inteiro em uma string.

SELECT CONVERT(char(4), 2008);

Neste exemplo, a data e hora atuais são convertidas em um tipo de dados de caractere variável:

SELECT CONVERT(VARCHAR(30), GETDATE());

getdate
---------
2023-02-02 04:31:16

Este exemplo converte a coluna saletime para remover as datas de cada linha e manter apenas a hora.

SELECT CONVERT(time, saletime), salesid
FROM sales order by salesid limit 10;

O exemplo a seguir converte dados de caracteres variáveis em objetos de data e hora.

SELECT CONVERT(datetime, '2008-02-18 02:36:48') as mysaletime;