Числовые функции

Числовые функции — это функции для работы с данными числовых типов: BIGINT, NUMERIC и DOUBLE.

`abs()`

Описание	Вычисляет модуль числа.
Использование	`abs(num)`

Посмотреть примеры

SELECT
    abs(-1)  AS result_1,
    abs(0)   AS result_2,
    abs(1.1) AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 1        | 0        | 1.1      |
+----------+----------+----------+

`add()`

Описание	Складывает числа.
Использование	`add(num, num)`

См. также Оператор +.

Посмотреть примеры

SELECT
    add(1, 1)      AS result_1,
    add(-1.1, 2.1) AS result_2,
    add(1)         AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 2        | 1.0      | 1        |
+----------+----------+----------+

`ceil()`

Описание	Округляет число в бОльшую сторону.
Использование	`ceil(num)`
Псевдонимы	`ceiling()`

Посмотреть примеры

SELECT
    ceil(0.1)  AS result_1,
    ceil(-0.1) AS result_2,
    ceiling(1) AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 1        | 0        | 1        |
+----------+----------+----------+

`cos()`

Описание	Вычисляет косинус угла, заданного в радианах.
Использование	`cos(num)`

Посмотреть примеры

SELECT
    cos(0)      AS result_1,
    cos(pi())   AS result_2,
    cos(pi()/3) AS result_3;

+----------+----------+--------------------+
| result_1 | result_2 | result_3           |
+----------+----------+--------------------+
| 1        | -1       | 0.5000000000000001 |
+----------+----------+--------------------+

`divide()`

Описание	Возвращает результат деления в виде целого числа.
Использование	`divide(num, num)`

Посмотреть примеры

SELECT
    divide(7, 2)  AS result_1,
    divide(7, -2) AS result_2,
    divide(7, 0)  AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 3        | -3       | null     |
+----------+----------+----------+

`even()`

Описание	Округляет до ближайшего четного числа в сторону от нуля.
Использование	`even(num)`

Посмотреть примеры

SELECT
    even(2.1)  AS result_1,
    even(-2.1) AS result_2,
    even(0)    AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 4        | -4       | 0        |
+----------+----------+----------+

`exp()`

Описание	Вычисляет экспоненту числа.
Использование	`exp(num)`

Вычисляет экспоненциальное значение числа: .

Посмотреть примеры

SELECT
    exp(0)  AS result_1,
    exp(1)  AS result_2,
    exp(-1) AS result_3;

+----------+-------------------+---------------------+
| result_1 | result_2          | result_3            |
+----------+-------------------+---------------------+
| 1        | 2.718281828459045 | 0.36787944117144233 |
+----------+-------------------+---------------------+

`floor()`

Описание	Округляет число в меньшую сторону.
Использование	`floor(num)`

Посмотреть примеры

SELECT
    floor(0.9)  AS result_1,
    floor(-0.9) AS result_2,
    floor(1)    AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 0        | -1       | 1        |
+----------+----------+----------+

`fmod()`

Описание	Возвращает остаток от деления первого аргумента на второй.
Использование	`fmod(num, num)`

Посмотреть примеры

SELECT
    fmod(3, 2)   AS result_1,
    fmod(3.1, 2) AS result_2,
    fmod(-10, 4) AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 1        | 1.1      | 2        |
+----------+----------+----------+

`gcd()`

Описание	Вычисляет наибольший общий делитель двух чисел.
Использование	`gcd(num, num)`
Псевдонимы	`greatest_common_divisor()`

Посмотреть примеры

SELECT
    gcd(12, 9)  AS result_1,
    gcd(-12, 9) AS result_2,
    gcd(12, 0)  AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 3        | 3        | 12       |
+----------+----------+----------+

`greatest()`

Описание	Возвращает наибольшее число из указанных в аргументах.
Использование	`greatest(num[, num, ...])`

Посмотреть примеры

SELECT
    greatest(1, 2, 3, 4, 4) AS result_1,
    greatest(1, -1)         AS result_2,
    greatest(0)             AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 4        | 1        | 0        |
+----------+----------+----------+

`isfinite()`

Описание	Проверяет, является ли число конечным.
Использование	`isfinite(num)`

Посмотреть примеры

SELECT
    isfinite(1)                  AS result_1,
    isfinite('Infinity'::DOUBLE) AS result_2,
    isfinite(NULL)               AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| true     | false    | null     |
+----------+----------+----------+

`isinf()`

Описание	Проверяет, является ли число бесконечным.
Использование	`isinf(num)`

Посмотреть примеры

SELECT
    isinf(1)                  AS result_1,
    isinf('Infinity'::DOUBLE) AS result_2,
    isinf(NULL)               AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| false    | true     | null     |
+----------+----------+----------+

`isnan()`

Описание	Проверяет, имеет ли аргумент значение `NaN` (Not a Number).
Использование	`isnan(num)`

Посмотреть примеры

SELECT
    isnan('NaN'::DOUBLE) AS result_1,
    isnan(1.1)           AS result_2,
    isnan(NULL)          AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| true     | false    | null     |
+----------+----------+----------+

`lcm()`

Описание	Вычисляет наименьшее общее кратное двух чисел.
Использование	`lcm(num, num)`
Псевдонимы	`least_common_multiple()`

Посмотреть примеры

SELECT
    lcm(3, 7)     AS result_1,
    lcm(333, 777) AS result_2,
    lcm(37, 0)    AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 21       | 2331     | 0        |
+----------+----------+----------+

`least()`

Описание	Возвращает наименьшее число из указанных в аргументах.
Использование	`least(num[, num, ...])`

Посмотреть примеры

SELECT
    least(1, 1, 2, 3, 4) AS result_1,
    least(1, -1)         AS result_2,
    least(0)             AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 1        | -1       | 0        |
+----------+----------+----------+

`lgamma()`

Описание	Вычисляет логарифм гамма-функции.
Использование	`lgamma(num)`

Посмотреть примеры

SELECT
    lgamma(1)   AS result_1,
    lgamma(11)  AS result_2,
    lgamma(1.1) AS result_3;

+----------+--------------------+-----------------------+
| result_1 | result_2           | result_3              |
+----------+--------------------+-----------------------+
| 0        | 15.104412573075518 | -0.049872441259839764 |
+----------+--------------------+-----------------------+

`ln()`

Описание	Вычисляет натуральный логарифм числа.
Использование	`ln(num)`

Посмотреть примеры

SELECT
    ln(1)   AS result_1,
    ln(11)  AS result_2,
    ln(1.1) AS result_3;

+----------+--------------------+---------------------+
| result_1 | result_2           | result_3            |
+----------+--------------------+---------------------+
| 0        | 2.3978952727983707 | 0.09531017980432493 |
+----------+--------------------+---------------------+

`log()`

Описание	Вычисляет логарифм числа по основанию `10`.
Использование	`log(num)`
Псевдонимы	`log10()`

Посмотреть примеры

SELECT
    log(1)    AS result_1,
    log(100)  AS result_2,
    log(0.01) AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 0        | 2        | -2       |
+----------+----------+----------+

`log2()`

Описание	Вычисляет логарифм числа по основанию `2`.
Использование	`log2(num)`

Посмотреть примеры

SELECT
    log2(1)    AS result_1,
    log2(2)    AS result_2,
    log2(4096) AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 0        | 1        | 12       |
+----------+----------+----------+

`multiply()`

Описание	Перемножает два числа.
Использование	`multiply(num, num)`

См. также Оператор *.

Посмотреть примеры

SELECT
    multiply(2, 2)      AS result_1,
    multiply(0, 2)      AS result_2,
    multiply(0.2, -0.2) AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 4        | 0        | -0.04    |
+----------+----------+----------+

`nextafter()`

Описание	Возвращает следующее значение с переменной точностью (типа `DOUBLE`) после первого числа в направлении второго числа.
Использование	`nextafter(num, num)`

Посмотреть примеры

SELECT
    nextafter(1::DOUBLE, 2)  AS result_1,
    nextafter(1::BIGINT, 2)  AS result_2,
    nextafter(-1::BIGINT, 0) AS result_3;

+--------------------+--------------------+---------------------+
|      result_1      |      result_2      |       result_3      |
+--------------------+--------------------+---------------------+
| 1.0000000000000002 | 1.0000000000000002 | -0.9999999999999999 |
+--------------------+--------------------+---------------------+

`pi()`

Описание	Возвращает значение числа π.
Использование	`pi()`

Посмотреть примеры

SELECT
    pi()   AS result_1,
    pi()/2 AS result_2,
    2*pi() AS result_3;

+-------------------+--------------------+-------------------+
|      result_1     |      result_2      |      result_3     |
+-------------------+--------------------+-------------------+
| 3.141592653589793 | 1.5707963267948966 | 6.283185307179586 |
+-------------------+--------------------+-------------------+

`pow()`

Описание	Возводит первый аргумент в степень, заданную вторым аргументом.
Использование	`pow(num, num)`
Псевдонимы	`power()`

См. также Оператор ^.

Посмотреть примеры

SELECT
    pow(2, 5)   AS result_1,
    pow(25, -1) AS result_2,
    pow(25, 0)  AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 32       | 0.04     | 1        |
+----------+----------+----------+

`radians()`

Описание	Переводит градусы в радианы.
Использование	`radians(num)`

Посмотреть примеры

SELECT
    radians(0)         AS result_1,
    radians(180)       AS result_2,
    radians(-180/pi()) AS result_3;

+----------+-------------------+----------+
| result_1 |      result_2     | result_3 |
+----------+-------------------+----------+
| 0        | 3.141592653589793 | -1       |
+----------+-------------------+----------+

`random()`

Описание	Возвращает произвольное число (типа `DOUBLE`) в интервале от `0` до `1`.
Использование	`random()`

См. также setseed().

Посмотреть примеры

SELECT
    random() AS result;

+--------------------+
|       result       |
+--------------------+
| 0.5656213557274057 |
+--------------------+

Функцию random() удобно использовать для выбора из таблицы произвольного сэмпла заданной длины.

Покажем на примере, как выбрать из таблицы с 1 миллионом строк случайный сэмпл размером 10:

CREATE TABLE demo.numbers (numbers BIGINT);

INSERT INTO demo.numbers (numbers)
    SELECT unnest(generate_series(1,1000000));

SELECT * FROM demo.numbers
ORDER BY random()
LIMIT 10;

+---------+
| numbers |
+---------+
| 265453  |
+---------+
| 16766   |
+---------+
| 861234  |
+---------+
| 455059  |
+---------+
| 898869  |
+---------+
| 454774  |
+---------+
| 465029  |
+---------+
| 885538  |
+---------+
| 465844  |
+---------+
| 50905   |
+---------+

`round_even()`

Описание	Округляет число из первого аргумента до ближайшего четного с указанной во втором аргументе точностью.
Использование	`round_even(num, num)`
Псевдонимы	`roundbankers()`

Второй аргумент указывает на количество десятичных знаков точности и может быть отрицательным числом.

Подробнее об округлении до ближайшего четного числа см. здесь.

Посмотреть примеры

SELECT
    round_even(4.5, 0)    AS result_1,
    round_even(3.5, 0)    AS result_2,
    round_even(-4.5, 0)   AS result_3,
    round_even(-3.5, 0)   AS result_4,
    round_even(4.45, 1)   AS result_5,
    round_even(4.35, 1)   AS result_6,
    round_even(35.35, -1) AS result_7;

+----------+----------+----------+----------+----------+----------+----------+
| result_1 | result_2 | result_3 | result_4 | result_5 | result_6 | result_7 |
+----------+----------+----------+----------+----------+----------+----------+
| 4        | 4        | -4       | -4       | 4.4      | 4.4      | 40       |
+----------+----------+----------+----------+----------+----------+----------+

`round()`

Описание	Округляет число из первого аргумента с указанной во втором аргументе точностью.
Использование	`round(num, num)`

Второй аргумент указывает на количество десятичных знаков точности и может быть отрицательным числом.

Посмотреть примеры

SELECT
    round(4.5, 0)   AS result_1,
    round(4.45, 1)  AS result_2,
    round(44.5, -1) AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 5        | 4.5      | 40       |
+----------+----------+----------+

`setseed()`

Описание	Фиксирует начальное значение для функции `random()`.
Использование	`setseed(num)`

См. также random().

Посмотреть примеры

SELECT
    setseed(0.5) AS seed,
    random() AS random;

+------+--------------------+
| seed | random             |
+------+--------------------+
| null | 0.8511131886287325 |
+------+--------------------+

`sign()`

Описание	Возвращает `-1`, `1` или `0` в зависимости от знака аргумента.
Использование	`sign(num)`

Посмотреть примеры

SELECT
    sign(10)  AS result_1,
    sign(-10) AS result_2,
    sign(0)   AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 1        | -1       | 0        |
+----------+----------+----------+

`signbit()`

Описание	Определяет, установлен ли бит знака у вещественного числа.
Использование	`signbit(num)`

Посмотреть примеры

SELECT
    signbit(-1)                  AS result_1,
    signbit(-'Infinity'::DOUBLE) AS result_2,
    signbit(0)                   AS result_3,
    signbit(1)                   AS result_4,
    signbit('Infinity'::DOUBLE)  AS result_5;

+----------+----------+----------+----------+----------+
| result_1 | result_2 | result_3 | result_4 | result_5 |
+----------+----------+----------+----------+----------+
| true     | true     | false    | false    | false    |
+----------+----------+----------+----------+----------+

`sin()`

Описание	Вычисляет синус угла, заданного в радианах.
Использование	`sin(num)`

Посмотреть примеры

SELECT
    sin(0)          AS result_1,
    sin(pi()/2)     AS result_2,
    sin((3*pi())/2) AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 0        | 1        | -1       |
+----------+----------+----------+

`sqrt()`

Описание	Вычисляет квадратный корень.
Использование	`sqrt(num)`

Число num должно быть неотрицательным.

Посмотреть примеры

SELECT
    sqrt(4)   AS result_1,
    sqrt(144) AS result_2,
    sqrt(0)   AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 2        | 12       | 0        |
+----------+----------+----------+

`subtract()`

Описание	Вычитает второй аргумент из первого.
Использование	`subtract(num, num)`

См. также Оператор -.

Посмотреть примеры

SELECT
    subtract(1, 2)     AS result_1,
    subtract(1.1, 2.2) AS result_2,
    subtract(-1, -2)   AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| -1       | -1.1     | 1        |
+----------+----------+----------+

`trunc()`

Описание	Отбрасывает все знаки после десятичного разделителя.
Использование	`trunc(num)`

Не следует путать с округлением round.

Посмотреть примеры

SELECT
    trunc(1.99)  AS result_1,
    trunc(-11.9) AS result_2,
    trunc(0.119) AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 1        | -11      | 0        |
+----------+----------+----------+

Оператор `+`

Описание	Прибавляет правый аргумент к левому.
Использование	`<num> + <num> [+ ...]` или `TIME + INTERVAL [+ ...]`

Если используется с типами для для даты и времени, то прибавляет интервал к значению времени. Возвращает значение типа TIME.

См. также add().

Посмотреть примеры

SELECT
    3 + 2      AS result_1,
    3 + 2 + -1 AS result_2,
    1.1 + 1.9  AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 5        | 4        | 3.0      |
+----------+----------+----------+

SELECT
    TIME '12:11:10'     + INTERVAL 3 hours AS result_time_1,
    INTERVAL '12:11:10' + TIME '1:1:1'     AS result_time_2;

+---------------+---------------+
| result_time_1 | result_time_2 |
+---------------+---------------+
| 15:11:10      | 13:12:11      |
+---------------+---------------+

Оператор `-`

Описание	Вычитает правый аргумент из левого.
Использование	`<num> - <num> [- ...]` или `TIME - INTERVAL [- ...]`

Если используется с типами для для даты и времени, то вычитает интервал из значения времени. Возвращает значение типа TIME.

См. также subtract().

Посмотреть примеры

SELECT
    3 - 2      AS result_1,
    3 - 2 - +1 AS result_2,
    1.2 - 0.2  AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 1        | 0        | 1.0      |
+----------+----------+----------+

SELECT
    TIME '12:11:10' - INTERVAL 3 HOUR AS result_time_1,
    TIME '12:11:10' - INTERVAL 3 HOUR - INTERVAL 1 HOUR AS result_time_2;

+---------------+---------------+
| result_time_1 | result_time_2 |
+---------------+---------------+
| 09:11:10      | 08:11:10      |
+---------------+---------------+

Оператор `*`

Описание	Перемножает аргументы.
Использование	`<num> * <num>[ * <num>, ...]`

См. также multiply().

Посмотреть примеры

SELECT
    3*2     AS result_1,
    3*+2*-2 AS result_2,
    3*0     AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 6        | -12      | 0        |
+----------+----------+----------+

Оператор `/`

Описание	Делит левый аргумент на правый.
Использование	`<num> / <num>[ / <num>, ...]`

Возвращает результат в виде числа с переменной точностью (типа DOUBLE).

Посмотреть примеры

SELECT
    3/2     AS result_1,
    3/+2/-2 AS result_2,
    3/1     AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 1.5      | -0.75    | 3        |
+----------+----------+----------+

Оператор `%`

Описание	Возвращает остаток от деления левого аргумента на правый.
Использование	`<num> % <num>[ % <num>, ...]`

Посмотреть примеры

SELECT
    3 % 2       AS result_1,
    15 % 10 % 3 AS result_2,
    5 % 2.4     AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 1        | 2        | 0.2      |
+----------+----------+----------+

Оператор `^`

Описание	Возводит левый аргумент в степень, заданную правым аргументом.
Использование	`<num> ^ <num>[ ^ <num>, ...]`

См. также pow().

Посмотреть примеры

SELECT
    2^3   AS result_1,
    2^3^2 AS result_2,
    1^0   AS result_3;

+----------+----------+----------+
| result_1 | result_2 | result_3 |
+----------+----------+----------+
| 8        | 64       | 1        |
+----------+----------+----------+

Числовые функции

abs()

add()

ceil()

cos()

divide()

even()

exp()

floor()

fmod()

gcd()

greatest()

isfinite()

isinf()

isnan()

lcm()

least()

lgamma()

ln()

log()

log2()

multiply()

nextafter()

pi()

pow()

radians()

random()

round_even()

round()

setseed()

sign()

signbit()

sin()

sqrt()

subtract()

trunc()

Оператор +

Оператор -

Оператор *

Оператор /

Оператор %

Оператор ^

`abs()`

`add()`

`ceil()`

`cos()`

`divide()`

`even()`

`exp()`

`floor()`

`fmod()`

`gcd()`

`greatest()`

`isfinite()`

`isinf()`

`isnan()`

`lcm()`

`least()`

`lgamma()`

`ln()`

`log()`

`log2()`

`multiply()`

`nextafter()`

`pi()`

`pow()`

`radians()`

`random()`

`round_even()`

`round()`

`setseed()`

`sign()`

`signbit()`

`sin()`

`sqrt()`

`subtract()`

`trunc()`

Оператор `+`

Оператор `-`

Оператор `*`

Оператор `/`

Оператор `%`

Оператор `^`