Menu

PostgreSQL CAST et l'opérateur :: (conversion de type)

CAST(valeur AS type) et valeur::type convertissent une valeur vers un autre type dans PostgreSQL. C'est la même conversion ; :: est la syntaxe courte de PostgreSQL.

Cette page contient des éditeurs exécutables. Modifiez, exécutez et voyez la sortie instantanément.

CAST(value AS type) convertit une valeur vers un autre type, et value::type est la forme courte de PostgreSQL pour la même chose. '42'::integer et CAST('42' AS integer) renvoient tous les deux l'entier 42. Une troisième forme, type 'literal' (comme dans date '2026-11-17'), ne fonctionne que pour les constantes.

Le texte '2026-11-17' devient une date, donc ajouter 30 donne la date 30 jours plus tard. 'yes' fait partie des écritures que boolean accepte, avec true, t, on et 1.

Convertir du texte en nombre ou en date

Les données chargées depuis un fichier CSV ou un formulaire arrivent souvent sous forme de texte. Convertissez-les avant de comparer ou de calculer, car comparé comme du texte, '10' passe avant '9' :

Triés comme des entiers, 9 passe avant 10, et les totaux de ligne valent 40.5 et 120. Les espaces au début et à la fin sont acceptés (' 42 '::integer fonctionne), mais tout autre caractère parasite lève « invalid input syntax for type integer ». Pour un texte dans un autre format, comme '17/11/2026' ou '1,234.50', utilisez to_date et to_number avec un motif de format.

Arrondi et division entière

Convertir un numeric en entier arrondit la moitié en s'éloignant de zéro. Convertir une valeur double precision arrondit la moitié au pair le plus proche. La division entière supprime la partie décimale :

Les résultats sont 3, -3, 2, 4, 3, 3.5 et 12. Utilisez trunc() ou floor() avant la conversion quand vous voulez couper la partie décimale au lieu d'arrondir.

Convertir vers un type plus petit vérifie la plage : 70000::smallint échoue avec « smallint out of range », et 12.345::numeric(5, 2) est arrondi à 12.35.

Vérifier l'entrée avant de convertir

Une conversion qui échoue arrête toute l'instruction. Depuis PostgreSQL 16, pg_input_is_valid(text, type) teste si une conversion réussirait, et pg_input_error_info renvoie le message d'erreur sans le lever :

Seul '42' est un entier valide. '2026-02-30' ressemble à une date mais n'en est pas une, donc valid_date est faux pour cette valeur aussi. Pour la ligne NULL, chaque colonne vaut NULL, puisque convertir NULL donne NULL du nouveau type.

Quand PostgreSQL convertit à votre place

Un littéral entre guillemets n'a pas de type tant que PostgreSQL ne voit pas où il est utilisé. Donc WHERE id = '5' et '1' + 1 fonctionnent, le littéral étant lu comme un entier. Une valeur qui a déjà un type n'est pas convertie pour vous. '1'::text + 1 échoue avec « operator does not exist: text + integer », tout comme la comparaison d'une colonne text avec une colonne integer. Ajoutez la conversion vous-même.

Les écritures sont plus tolérantes. Un INSERT ou un UPDATE convertit une valeur vers le type de la colonne quand une conversion d'affectation existe, donc insérer le numeric 12.7 dans une colonne entière stocke 13.

Pour changer définitivement le type d'une colonne, convertissez chaque ligne une fois avec ALTER TABLE ... ALTER COLUMN ... TYPE ... USING :

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

La page sur les types de données liste les types vers lesquels vous pouvez convertir.

Questions fréquentes

Que signifie :: dans PostgreSQL ?

C'est l'opérateur de conversion de PostgreSQL : '42'::integer convertit le texte '42' en entier. Il fait la même chose que le CAST('42' AS integer) standard.

Faut-il utiliser CAST ou :: dans PostgreSQL ?

Ils se comportent de la même façon. :: est plus court et courant dans le code PostgreSQL. CAST(... AS ...) est du SQL standard que MySQL, SQL Server et SQLite acceptent aussi, donc utilisez-le dans les requêtes qui doivent rester portables.

Comment convertir sans erreur quand le texte n'est pas un nombre ?

Testez-le d'abord. Depuis PostgreSQL 16, pg_input_is_valid('4x2', 'integer') renvoie false au lieu de lever une erreur, donc CASE WHEN pg_input_is_valid(s, 'integer') THEN s::integer END donne NULL pour une entrée invalide. Sur les versions plus anciennes, vérifiez d'abord le texte avec une regex comme s ~ '^-?\d+$'.

Pourquoi 7 / 2 renvoie-t-il 3 dans PostgreSQL ?

Diviser deux entiers donne un entier et supprime la partie décimale. Convertissez l'un des deux en numeric pour obtenir 3.5 : 7::numeric / 2.

Illustration des langages de programmation de Coddy

Apprendre à coder avec Coddy

Commencer