mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-15 02:41:59 +00:00
984d6517c2
Co-authored-by: olgarev <56617294+olgarev@users.noreply.github.com>
161 lines
7.7 KiB
Markdown
161 lines
7.7 KiB
Markdown
---
|
||
toc_priority: 34
|
||
toc_title: "Арифметические функции"
|
||
---
|
||
|
||
# Арифметические функции {#arifmeticheskie-funktsii}
|
||
|
||
Для всех арифметических функций, тип результата вычисляется, как минимальный числовой тип, который может вместить результат, если такой тип есть. Минимум берётся одновременно по числу бит, знаковости и «плавучести». Если бит не хватает, то берётся тип максимальной битности.
|
||
|
||
Пример:
|
||
|
||
``` sql
|
||
SELECT toTypeName(0), toTypeName(0 + 0), toTypeName(0 + 0 + 0), toTypeName(0 + 0 + 0 + 0)
|
||
```
|
||
|
||
``` text
|
||
┌─toTypeName(0)─┬─toTypeName(plus(0, 0))─┬─toTypeName(plus(plus(0, 0), 0))─┬─toTypeName(plus(plus(plus(0, 0), 0), 0))─┐
|
||
│ UInt8 │ UInt16 │ UInt32 │ UInt64 │
|
||
└───────────────┴────────────────────────┴─────────────────────────────────┴──────────────────────────────────────────┘
|
||
```
|
||
|
||
Арифметические функции работают для любой пары типов из UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64, Float32, Float64.
|
||
|
||
Переполнение производится также, как в C++.
|
||
|
||
## plus(a, b), оператор a + b {#plusa-b-operator-a-b}
|
||
|
||
Вычисляет сумму чисел.
|
||
Также можно складывать целые числа с датой и датой-с-временем. В случае даты, прибавление целого числа означает прибавление соответствующего количества дней. В случае даты-с-временем - прибавление соответствующего количества секунд.
|
||
|
||
## minus(a, b), оператор a - b {#minusa-b-operator-a-b}
|
||
|
||
Вычисляет разность чисел. Результат всегда имеет знаковый тип.
|
||
|
||
Также можно вычитать целые числа из даты и даты-с-временем. Смысл аналогичен - смотрите выше для plus.
|
||
|
||
## multiply(a, b), оператор a \* b {#multiplya-b-operator-a-b}
|
||
|
||
Вычисляет произведение чисел.
|
||
|
||
## divide(a, b), оператор a / b {#dividea-b-operator-a-b}
|
||
|
||
Вычисляет частное чисел. Тип результата всегда является типом с плавающей запятой.
|
||
То есть, деление не целочисленное. Для целочисленного деления, используйте функцию intDiv.
|
||
При делении на ноль получится inf, -inf или nan.
|
||
|
||
## intDiv(a, b) {#intdiva-b}
|
||
|
||
Вычисляет частное чисел. Деление целочисленное, с округлением вниз (по абсолютному значению).
|
||
При делении на ноль или при делении минимального отрицательного числа на минус единицу, кидается исключение.
|
||
|
||
## intDivOrZero(a, b) {#intdivorzeroa-b}
|
||
|
||
Отличается от intDiv тем, что при делении на ноль или при делении минимального отрицательного числа на минус единицу, возвращается ноль.
|
||
|
||
## modulo(a, b), оператор a % b {#modulo}
|
||
|
||
Вычисляет остаток от деления.
|
||
Если аргументы - числа с плавающей запятой, то они предварительно преобразуются в целые числа, путём отбрасывания дробной части.
|
||
Берётся остаток в том же смысле, как это делается в C++. По факту, для отрицательных чисел, используется truncated division.
|
||
При делении на ноль или при делении минимального отрицательного числа на минус единицу, кидается исключение.
|
||
|
||
## moduloOrZero(a, b) {#modulo-or-zero}
|
||
|
||
В отличие от [modulo](#modulo), возвращает ноль при делении на ноль.
|
||
|
||
## negate(a), оператор -a {#negatea-operator-a}
|
||
|
||
Вычисляет число, обратное по знаку. Результат всегда имеет знаковый тип.
|
||
|
||
## abs(a) {#arithm_func-abs}
|
||
|
||
Вычисляет абсолютное значение для числа a. То есть, если a \< 0, то возвращает -a.
|
||
Для беззнаковых типов ничего не делает. Для чисел типа целых со знаком, возвращает число беззнакового типа.
|
||
|
||
## gcd(a, b) {#gcda-b}
|
||
|
||
Вычисляет наибольший общий делитель чисел.
|
||
При делении на ноль или при делении минимального отрицательного числа на минус единицу, кидается исключение.
|
||
|
||
## lcm(a, b) {#lcma-b}
|
||
|
||
Вычисляет наименьшее общее кратное чисел.
|
||
При делении на ноль или при делении минимального отрицательного числа на минус единицу, кидается исключение.
|
||
|
||
|
||
## max2 {#max2}
|
||
|
||
Сравнивает два числа и возвращает максимум. Возвращаемое значение приводится к типу [Float64](../../sql-reference/data-types/float.md).
|
||
|
||
**Синтаксис**
|
||
|
||
```sql
|
||
max2(value1, value2)
|
||
```
|
||
|
||
**Аргументы**
|
||
|
||
- `value1` — первое число. [Int/UInt](../../sql-reference/data-types/int-uint.md) или [Float](../../sql-reference/data-types/float.md).
|
||
- `value2` — второе число. [Int/UInt](../../sql-reference/data-types/int-uint.md) или [Float](../../sql-reference/data-types/float.md).
|
||
|
||
**Возвращаемое значение**
|
||
|
||
- Максимальное значение среди двух чисел.
|
||
|
||
Тип: [Float](../../sql-reference/data-types/float.md).
|
||
|
||
**Пример**
|
||
|
||
Запрос:
|
||
|
||
```sql
|
||
SELECT max2(-1, 2);
|
||
```
|
||
|
||
Результат:
|
||
|
||
```text
|
||
┌─max2(-1, 2)─┐
|
||
│ 2 │
|
||
└─────────────┘
|
||
```
|
||
|
||
## min2 {#min2}
|
||
|
||
Сравнивает два числа и возвращает минимум. Возвращаемое значение приводится к типу [Float64](../../sql-reference/data-types/float.md).
|
||
|
||
**Синтаксис**
|
||
|
||
```sql
|
||
min2(value1, value2)
|
||
```
|
||
|
||
**Аргументы**
|
||
|
||
- `value1` — первое число. [Int/UInt](../../sql-reference/data-types/int-uint.md) или [Float](../../sql-reference/data-types/float.md).
|
||
- `value2` — второе число. [Int/UInt](../../sql-reference/data-types/int-uint.md) или [Float](../../sql-reference/data-types/float.md).
|
||
|
||
**Возвращаемое значение**
|
||
|
||
- Минимальное значение среди двух чисел.
|
||
|
||
Тип: [Float](../../sql-reference/data-types/float.md).
|
||
|
||
**Пример**
|
||
|
||
Запрос:
|
||
|
||
```sql
|
||
SELECT min2(-1, 2);
|
||
```
|
||
|
||
Результат:
|
||
|
||
```text
|
||
┌─min2(-1, 2)─┐
|
||
│ -1 │
|
||
└─────────────┘
|
||
```
|
||
|