Menu

CAST e o operador :: no PostgreSQL

CAST(value AS type) e value::type convertem um valor para outro tipo no PostgreSQL. As duas fazem a mesma conversão; :: é a sintaxe curta do PostgreSQL.

Esta página tem editores executáveis. Edite, execute e veja a saída na hora.

CAST(value AS type) converte um valor para outro tipo, e value::type é a forma curta do PostgreSQL para a mesma coisa. '42'::integer e CAST('42' AS integer) retornam o inteiro 42. Uma terceira forma, type 'literal' (como em date '2026-11-17'), funciona só para constantes.

O texto '2026-11-17' vira uma data, então somar 30 dá a data 30 dias depois. 'yes' é uma das grafias que o boolean aceita, junto com true, t, on e 1.

Converter texto em número ou data

Dados carregados de arquivos CSV ou formulários costumam chegar como texto. Converta antes de comparar ou calcular, porque, comparado como texto, '10' vem antes de '9':

Ordenados como inteiros, 9 vem antes de 10, e os totais das linhas são 40.5 e 120. Espaços no início e no fim são permitidos (' 42 '::integer funciona), mas qualquer outro caractere sobrando gera "invalid input syntax for type integer". Para texto em outro formato, como '17/11/2026' ou '1,234.50', use to_date e to_number com um padrão de formato.

Arredondamento e divisão inteira

Converter um numeric para inteiro arredonda a metade para longe do zero. Converter um double precision arredonda a metade para o par mais próximo. A divisão inteira descarta a parte fracionária:

Os resultados são 3, -3, 2, 4, 3, 3.5 e 12. Use trunc() ou floor() antes da conversão quando quiser cortar a parte fracionária em vez de arredondar.

Converter para um tipo menor verifica o intervalo: 70000::smallint falha com "smallint out of range", e 12.345::numeric(5, 2) arredonda para 12.35.

Validar a entrada antes de converter

Uma conversão que falha interrompe a instrução inteira. Desde o PostgreSQL 16, pg_input_is_valid(text, type) testa se uma conversão daria certo, e pg_input_error_info retorna a mensagem de erro sem gerá-lo:

Só '42' é um inteiro válido. '2026-02-30' parece uma data, mas não é, então valid_date também é falso para ele. Na linha NULL todas as colunas são NULL, já que converter NULL dá NULL do novo tipo.

Quando o PostgreSQL converte por você

Um literal entre aspas não tem tipo até o PostgreSQL ver onde ele é usado. Por isso WHERE id = '5' e '1' + 1 funcionam, com o literal lido como inteiro. Um valor que já tem tipo não é convertido automaticamente. '1'::text + 1 falha com "operator does not exist: text + integer", e o mesmo acontece ao comparar uma coluna text com uma coluna integer. Faça a conversão você mesmo.

As escritas são mais tolerantes. Um INSERT ou UPDATE converte o valor para o tipo da coluna quando existe uma conversão de atribuição, então inserir o numeric 12.7 numa coluna inteira grava 13.

Para mudar o tipo de uma coluna de vez, converta cada linha uma única vez com ALTER TABLE ... ALTER COLUMN ... TYPE ... USING:

ALTER TABLE imports ALTER COLUMN qty TYPE integer USING qty::integer;

A página de tipos de dados lista os tipos para os quais você pode converter.

Perguntas frequentes

O que significa :: no PostgreSQL?

É o operador de conversão do PostgreSQL: '42'::integer converte o texto '42' em inteiro. Faz o mesmo que o CAST('42' AS integer) padrão.

Devo usar CAST ou :: no PostgreSQL?

Os dois se comportam igual. :: é mais curto e comum em código PostgreSQL. CAST(... AS ...) é SQL padrão que MySQL, SQL Server e SQLite também aceitam, então use em consultas que precisam ser portáveis.

Como converter sem erro quando o texto não é um número?

Teste antes. Desde o PostgreSQL 16, pg_input_is_valid('4x2', 'integer') retorna false em vez de gerar um erro, então CASE WHEN pg_input_is_valid(s, 'integer') THEN s::integer END dá NULL para entradas inválidas. Em versões mais antigas, verifique o texto antes com uma expressão regular como s ~ '^-?\d+$'.

Por que 7 / 2 retorna 3 no PostgreSQL?

Dividir dois inteiros dá um inteiro e descarta a parte fracionária. Converta um dos lados para numeric para obter 3.5: 7::numeric / 2.

Ilustração das linguagens de programação do Coddy

Aprenda a programar com o Coddy

Começar