Menu

CAST и оператор :: в PostgreSQL: приведение типов

CAST(value AS type) и value::type переводят значение в другой тип в PostgreSQL. Это одно и то же преобразование; :: просто более короткая запись PostgreSQL.

На этой странице есть исполняемые редакторы: меняйте, запускайте и сразу видите результат.

CAST(value AS type) переводит значение в другой тип, а value::type это более короткая запись того же самого в PostgreSQL. И '42'::integer, и CAST('42' AS integer) возвращают целое число 42. Третья форма, type 'literal' (как в date '2026-11-17'), работает только для констант.

Текст '2026-11-17' становится датой, поэтому прибавление 30 даёт дату на 30 дней позже. 'yes' входит в число написаний, которые принимает boolean, наряду с true, t, on и 1.

Преобразовать текст в число или дату

Данные из CSV-файлов или форм часто приходят как текст. Приводите их к нужному типу до сравнения или вычислений, потому что при сравнении как текст '10' идёт раньше '9':

При сортировке как целых чисел 9 идёт раньше 10, а суммы по строкам равны 40.5 и 120. Пробелы в начале и в конце допустимы (' 42 '::integer работает), но любой другой лишний символ вызывает ошибку «invalid input syntax for type integer». Для текста в другом формате, например '17/11/2026' или '1,234.50', используйте to_date и to_number с шаблоном формата.

Округление и целочисленное деление

При приведении numeric к целому числу половина округляется от нуля. При приведении double precision половина округляется к чётному. Целочисленное деление отбрасывает дробную часть:

Результаты: 3, -3, 2, 4, 3, 3.5 и 12. Если нужно отрезать дробную часть, а не округлить, вызовите trunc() или floor() перед приведением.

При приведении к меньшему типу проверяется диапазон: 70000::smallint завершается ошибкой «smallint out of range», а 12.345::numeric(5, 2) округляется до 12.35.

Проверить входные данные перед приведением

Неудачное приведение останавливает всю команду. Начиная с PostgreSQL 16, pg_input_is_valid(text, type) проверяет, получится ли приведение, а pg_input_error_info возвращает текст ошибки, не вызывая её:

Корректное целое число здесь только '42'. '2026-02-30' похоже на дату, но датой не является, поэтому valid_date для него тоже false. В строке с NULL все столбцы равны NULL, так как приведение NULL даёт NULL нового типа.

Когда PostgreSQL приводит тип сам

Литерал в кавычках не имеет типа, пока PostgreSQL не увидит, где он используется. Поэтому WHERE id = '5' и '1' + 1 работают: литерал читается как целое число. Значение, у которого тип уже есть, само не преобразуется. '1'::text + 1 завершается ошибкой «operator does not exist: text + integer», как и сравнение столбца text со столбцом integer. Добавьте приведение сами.

При записи правила мягче. INSERT или UPDATE переводит значение в тип столбца, если для этого есть приведение при присваивании, поэтому вставка numeric 12.7 в целочисленный столбец сохранит 13.

Чтобы навсегда сменить тип столбца, приведите каждую строку один раз через ALTER TABLE ... ALTER COLUMN ... TYPE ... USING:

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

На странице о типах данных перечислены типы, к которым можно приводить значения.

Часто задаваемые вопросы

Что означает :: в PostgreSQL?

Это оператор приведения типа в PostgreSQL: '42'::integer превращает текст '42' в целое число. Он делает то же самое, что стандартный CAST('42' AS integer).

Что использовать в PostgreSQL: CAST или ::?

Они работают одинаково. :: короче и привычен в коде на PostgreSQL. CAST(... AS ...) это стандартный SQL, который понимают также MySQL, SQL Server и SQLite, поэтому используйте его в запросах, которые должны оставаться переносимыми.

Как привести тип без ошибки, если текст не число?

Сначала проверьте его. Начиная с PostgreSQL 16, pg_input_is_valid('4x2', 'integer') возвращает false вместо ошибки, поэтому CASE WHEN pg_input_is_valid(s, 'integer') THEN s::integer END даёт NULL для неверного ввода. В старых версиях заранее проверьте текст регулярным выражением, например s ~ '^-?\d+$'.

Почему 7 / 2 в PostgreSQL возвращает 3?

Деление двух целых чисел даёт целое число и отбрасывает дробную часть. Приведите одну из сторон к numeric, чтобы получить 3.5: 7::numeric / 2.

Иллюстрация языков программирования Coddy

Учитесь программировать с Coddy

Начать