Menu

CAST y el operador :: en PostgreSQL

CAST(value AS type) y value::type convierten un valor a otro tipo en PostgreSQL. Son la misma conversión; :: es la sintaxis corta de PostgreSQL.

Esta página incluye editores ejecutables: edita, ejecuta y ve el resultado al instante.

CAST(value AS type) convierte un valor a otro tipo, y value::type es la forma corta de PostgreSQL para lo mismo. '42'::integer y CAST('42' AS integer) devuelven los dos el entero 42. Una tercera forma, type 'literal' (como en date '2026-11-17'), solo sirve para constantes.

El texto '2026-11-17' pasa a ser una fecha, así que sumarle 30 da la fecha 30 días después. 'yes' es una de las formas que acepta boolean, junto con true, t, on y 1.

Convertir texto a número o a fecha

Los datos que vienen de archivos CSV o de formularios suelen llegar como texto. Conviértelos antes de comparar o calcular, porque comparado como texto, '10' va antes que '9':

Ordenados como enteros, 9 va antes que 10, y los totales de línea son 40.5 y 120. Se permiten espacios al principio y al final (' 42 '::integer funciona), pero cualquier otro carácter suelto lanza "invalid input syntax for type integer". Para texto en otro formato, como '17/11/2026' o '1,234.50', usa to_date y to_number con un patrón de formato.

Redondeo y división entera

Convertir un numeric a entero redondea la mitad alejándose de cero. Convertir un double precision redondea la mitad al par más cercano. La división entera descarta la parte decimal:

Los resultados son 3, -3, 2, 4, 3, 3.5 y 12. Usa trunc() o floor() antes de la conversión cuando quieras cortar los decimales en vez de redondear.

Convertir a un tipo más pequeño comprueba el rango: 70000::smallint falla con "smallint out of range", y 12.345::numeric(5, 2) redondea a 12.35.

Validar la entrada antes de convertir

Una conversión fallida detiene toda la sentencia. Desde PostgreSQL 16, pg_input_is_valid(text, type) comprueba si una conversión funcionaría, y pg_input_error_info devuelve el mensaje de error sin lanzarlo:

Solo '42' es un entero válido. '2026-02-30' parece una fecha pero no lo es, así que valid_date también es falso para ese valor. En la fila NULL todas las columnas son NULL, porque convertir NULL da NULL del tipo nuevo.

Cuándo convierte PostgreSQL por ti

Un literal entre comillas no tiene tipo hasta que PostgreSQL ve dónde se usa. Por eso WHERE id = '5' y '1' + 1 funcionan, con el literal leído como entero. Un valor que ya tiene tipo no se convierte solo. '1'::text + 1 falla con "operator does not exist: text + integer", y lo mismo pasa al comparar una columna text con una columna integer. Añade tú la conversión.

Las escrituras son más permisivas. Un INSERT o un UPDATE convierte un valor al tipo de la columna cuando existe una conversión de asignación, así que insertar el numeric 12.7 en una columna entera guarda 13.

Para cambiar el tipo de una columna de forma permanente, convierte cada fila una sola vez con ALTER TABLE ... ALTER COLUMN ... TYPE ... USING:

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

La página de tipos de datos enumera los tipos a los que puedes convertir.

Preguntas frecuentes

¿Qué significa :: en PostgreSQL?

Es el operador de conversión de PostgreSQL: '42'::integer convierte el texto '42' en un entero. Hace lo mismo que el CAST('42' AS integer) estándar.

¿Uso CAST o :: en PostgreSQL?

Se comportan igual. :: es más corto y muy común en código de PostgreSQL. CAST(... AS ...) es SQL estándar que también aceptan MySQL, SQL Server y SQLite, así que úsalo en consultas que deban ser portables.

¿Cómo convierto sin error cuando el texto no es un número?

Compruébalo primero. Desde PostgreSQL 16, pg_input_is_valid('4x2', 'integer') devuelve false en lugar de lanzar un error, así que CASE WHEN pg_input_is_valid(s, 'integer') THEN s::integer END da NULL para la entrada inválida. En versiones anteriores, revisa el texto antes con una expresión regular como s ~ '^-?\d+$'.

¿Por qué 7 / 2 devuelve 3 en PostgreSQL?

Dividir dos enteros da un entero y descarta la parte decimal. Convierte un lado a numeric para obtener 3.5: 7::numeric / 2.

Ilustración de los lenguajes de programación de Coddy

Aprende a programar con Coddy

Comenzar