Função CAST

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

A função CAST é muito semelhante à Função CONVERT, pois ambas convertem um tipo de dado em outro, mas têm nomes diferentes.

Determinados tipos de dados exigem uma conversão explícita para outros tipos de dados usando a função CAST ou 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

Use uma dessas duas formas equivalentes de sintaxe para transmitir expressões de um tipo de dados para outro.

CAST ( expression AS type )
expression :: type

Argumentos

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

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

Tipo de retorno

CAST 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 123.456::decimal(2,1);

ou uma conversão INTEGER que causa um transbordamento:

select 12345678::smallint;

Exemplos

As seguintes duas consultas são equivalentes. Ambas convertem um valor decimal em um número inteiro:

select cast(pricepaid as integer)
from sales where salesid=100;

pricepaid
-----------
162
(1 row)

select pricepaid::integer
from sales where salesid=100;

pricepaid
-----------
162
(1 row)

O seguinte produz um resultado semelhante. Ele não exige dados de exemplo para ser executado:

select cast(162.00 as integer) as pricepaid;

pricepaid
-----------
162
(1 row)

Neste exemplo, os valores em uma coluna de carimbo de data/hora são transmitidos como datas, o que resulta na remoção do horário de cada resultado:

select cast(saletime as date), salesid
from sales order by salesid limit 10;

 saletime  | salesid
-----------+---------
2008-02-18 |       1
2008-06-06 |       2
2008-06-06 |       3
2008-06-09 |       4
2008-08-31 |       5
2008-07-16 |       6
2008-06-26 |       7
2008-07-10 |       8
2008-07-22 |       9
2008-08-06 |      10

(10 rows)

Se você não usasse CAST conforme ilustrado no exemplo anterior, os resultados incluiriam o horário: 2008-02-18 02:36:48.

A consulta a seguir converte dados de caracteres variáveis em uma data. Ele não exige dados de exemplo para ser executado.

select cast('2008-02-18 02:36:48' as date) as mysaletime;

mysaletime    
--------------------
2008-02-18  
(1 row)

Neste exemplo, os valores em uma coluna de data são convertidos como timestamps:

select cast(caldate as timestamp), dateid
from date order by dateid limit 10;

      caldate       | dateid
--------------------+--------
2008-01-01 00:00:00 |   1827
2008-01-02 00:00:00 |   1828
2008-01-03 00:00:00 |   1829
2008-01-04 00:00:00 |   1830
2008-01-05 00:00:00 |   1831
2008-01-06 00:00:00 |   1832
2008-01-07 00:00:00 |   1833
2008-01-08 00:00:00 |   1834
2008-01-09 00:00:00 |   1835
2008-01-10 00:00:00 |   1836

(10 rows)

Em um caso como o exemplo anterior, você pode obter controle adicional sobre a formatação de saída usandoTO_CHAR.

Neste exemplo, um número inteiro é convertido como uma string de caracteres:

select cast(2008 as char(4));

bpchar
--------
2008

Neste exemplo, um valor DECIMAL(6,3) é convertido como um valor DECIMAL(4,1):

select cast(109.652 as decimal(4,1));

numeric
---------
109.7

Este exemplo mostra uma expressão mais complexa. A coluna PRICEPAID (uma coluna DECIMAL(8,2)) na tabela SALES é convertida em uma coluna DECIMAL(38,2) e os valores são multiplicados por 100.000.000.000.000.000.000.

select salesid, pricepaid::decimal(38,2)*100000000000000000000
as value from sales where salesid<10 order by salesid;


 salesid |           value
---------+----------------------------
       1 | 72800000000000000000000.00
       2 |  7600000000000000000000.00
       3 | 35000000000000000000000.00
       4 | 17500000000000000000000.00
       5 | 15400000000000000000000.00
       6 | 39400000000000000000000.00
       7 | 78800000000000000000000.00
       8 | 19700000000000000000000.00
       9 | 59100000000000000000000.00

(9 rows)