산술 함수 - ClickHouse Documentation

개요

산술 함수는 UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64, Float32 또는 Float64 타입의 임의의 두 피연산자에 대해 동작합니다. 연산을 수행하기 전에 두 피연산자는 결과 타입으로 변환됩니다. 결과 타입은 다음과 같이 결정됩니다(아래 함수 문서에서 별도로 지정하지 않는 한).

두 피연산자가 모두 32비트 이하이면 결과 타입의 크기는 두 피연산자 중 더 큰 타입보다 한 단계 큰 타입의 크기가 됩니다 (정수 크기 승격). 예를 들어 UInt8 + UInt16 = UInt32 또는 Float32 * Float32 = Float64입니다.
피연산자 중 하나가 64비트 이상이면 결과 타입의 크기는 두 피연산자 중 더 큰 타입과 동일한 크기가 됩니다. 예를 들어 UInt32 + UInt128 = UInt128 또는 Float32 * Float64 = Float64입니다.
피연산자 중 하나가 부호 있는 타입이면 결과 타입도 부호 있는 타입이 되고, 그렇지 않으면 부호 없는 타입이 됩니다. 예를 들어 UInt32 * Int32 = Int64 또는 UInt32 * UInt32 = UInt64입니다.

이 규칙은 결과 타입이 가능한 모든 결과를 표현할 수 있는 가장 작은 타입이 되도록 합니다. 이로 인해 값 범위 경계 부근에서는 오버플로우 위험이 생길 수 있지만, 최대 64비트 네이티브 정수 폭을 사용해 계산을 빠르게 수행할 수 있습니다. 또한 이러한 동작은 64비트 정수(BIGINT)를 가장 큰 정수 타입으로 제공하는 다른 많은 데이터베이스와의 호환성도 보장합니다. 예시:

SELECT toTypeName(0), toTypeName(0 + 0), toTypeName(0 + 0 + 0), toTypeName(0 + 0 + 0 + 0)

┌─toTypeName(0)─┬─toTypeName(plus(0, 0))─┬─toTypeName(plus(plus(0, 0), 0))─┬─toTypeName(plus(plus(plus(0, 0), 0), 0))─┐
│ UInt8         │ UInt16                 │ UInt32                          │ UInt64                                   │
└───────────────┴────────────────────────┴─────────────────────────────────┴──────────────────────────────────────────┘

오버플로우는 C++와 같은 방식으로 발생합니다.

abs

도입 버전: v1.1.0 x의 절대값을 계산합니다. x가 부호 없는 유형이면 값에 변화가 없습니다. x가 부호 있는 유형이면 부호 없는 숫자를 반환합니다. 구문

abs(x)

인수

x — 절댓값을 구할 대상 값

반환 값 x의 절댓값 예시 사용 예시

Query

SELECT abs(-0.5)

Response

0.5

avg2

도입 버전: v25.11.0 전달된 인수의 평균값을 계산해 반환합니다. 숫자 및 시간 관련 타입을 지원합니다. 구문

avg2(x1, x2])

인수

x1, x2] — 평균 계산에 사용할 두 값을 받습니다.

반환 값 제공된 인수의 평균값을 반환합니다. 결과는 호환 가능한 가장 큰 유형으로 승격됩니다. 예시 숫자 타입

Query

SELECT avg2(toUInt8(3), 1.0) AS result, toTypeName(result) AS type;
-- UInt8이 비교를 위해 64비트로 승격되어야 하므로 반환되는 유형은 Float64입니다.

Response

┌─result─┬─type────┐
│      2 │ Float64 │
└────────┴─────────┘

Decimal 타입

Query

SELECT avg2(toDecimal32(1, 2), 2) AS result, toTypeName(result) AS type;

Response

┌─result─┬─type──────────┐
│    1.5 │ Decimal(9, 2) │
└────────┴───────────────┘

날짜 타입

Query

SELECT avg2(toDate('2025-01-01'), toDate('2025-01-05')) AS result, toTypeName(result) AS type;

Response

┌─────result─┬─type─┐
│ 2025-01-03 │ Date │
└────────────┴──────┘

DateTime 타입

Query

SELECT avg2(toDateTime('2025-01-01 00:00:00'), toDateTime('2025-01-03 12:00:00')) AS result, toTypeName(result) AS type;

Response

┌──────────────result─┬─type─────┐
│ 2025-01-02 06:00:00 │ DateTime │
└─────────────────────┴──────────┘

Time64 타입

Query

SELECT avg2(toTime64('12:00:00', 0), toTime64('14:00:00', 0)) AS result, toTypeName(result) AS type;

Response

┌───result─┬─type──────┐
│ 13:00:00 │ Time64(0) │
└──────────┴───────────┘

byteSwap

도입 버전: v23.10.0 정수의 바이트 순서를 뒤집습니다. 즉, 엔디언 방식을 변경합니다. 아래 예시는 다음과 같은 방식으로 계산할 수 있습니다:

10진수 정수를 big-endian 기준의 16진수 포맷으로 변환합니다. 즉, 3351772109 -> C7 C7 FB CD (4바이트)
바이트 순서를 뒤집습니다. 즉, C7 C7 FB CD -> CD FB C7 C7
결과를 big-endian으로 가정하고 다시 정수로 변환합니다. 즉, CD FB C7 C7 -> 3455829959 이 함수의 한 가지 사용 예시는 IPv4의 바이트 순서를 뒤집는 것입니다:

┌─toIPv4(byteSwap(toUInt32(toIPv4('205.251.199.199'))))─┐
│ 199.199.251.205                                       │
└───────────────────────────────────────────────────────┘

구문

byteSwap(x)

인수

x — 정수형 값입니다. (U)Int*

반환 값 바이트 순서가 뒤바뀐 x를 반환합니다. (U)Int* 예시 사용 예시

Query

SELECT byteSwap(3351772109)

Response

3455829959

8비트

Query

SELECT byteSwap(54)

Response

16비트

Query

SELECT byteSwap(4135)

Response

32비트

Query

SELECT byteSwap(3351772109)

Response

3455829959

64비트

Query

SELECT byteSwap(123294967295)

Response

18439412204227788800

divide

도입 버전: v1.1.0 두 값 a와 b의 몫을 계산합니다. 결과 타입은 항상 Float64입니다. 정수 나눗셈에는 intDiv 함수를 사용합니다.

0으로 나누면 inf, -inf 또는 nan이 반환됩니다.

구문

divide(x, y)

인수

x — 피제수 - y — 제수

반환 값 x와 y를 나눈 몫 예시 두 수 나누기

Query

SELECT divide(25,5) AS quotient, toTypeName(quotient)

Response

5 Float64

0으로 나누기

Query

SELECT divide(25,0)

Response

inf

divideDecimal

도입 버전: v22.12.0 두 개의 Decimal 값에 대해 나눗셈을 수행합니다. 결과 값은 Decimal256 타입입니다. 결과 스케일은 result_scale 인수(const Integer, 범위 [0, 76])로 명시적으로 지정할 수 있습니다. 지정하지 않으면 결과 스케일은 주어진 인수 중 최댓값이 됩니다.

이 함수는 일반적인 divide보다 훨씬 느리게 동작합니다. 정밀도를 제어할 필요가 없거나 빠른 계산이 필요하다면 divide 사용을 고려하십시오.

구문

divideDecimal(x, y[, result_scale])

인수

x — 첫 번째 값: Decimal. - y — 두 번째 값: Decimal. - result_scale — 결과의 소수 자릿수입니다. 유형은 Int/UInt입니다.

반환 값 지정된 소수 자릿수가 적용된 나눗셈 결과입니다. Decimal256 예시 예시 1

Query

divideDecimal(toDecimal256(-12, 0), toDecimal32(2.1, 1), 10)

Response

┌─divideDecimal(toDecimal256(-12, 0), toDecimal32(2.1, 1), 10)─┐
│                                                -5.7142857142 │
└──────────────────────────────────────────────────────────────┘

예시 2

Query

SELECT toDecimal64(-12, 1) / toDecimal32(2.1, 1);
SELECT toDecimal64(-12, 1) as a, toDecimal32(2.1, 1) as b, divideDecimal(a, b, 1), divideDecimal(a, b, 5);

Response

┌─divide(toDecimal64(-12, 1), toDecimal32(2.1, 1))─┐
│                                             -5.7 │
└──────────────────────────────────────────────────┘
┌───a─┬───b─┬─divideDecimal(toDecimal64(-12, 1), toDecimal32(2.1, 1), 1)─┬─divideDecimal(toDecimal64(-12, 1), toDecimal32(2.1, 1), 5)─┐
│ -12 │ 2.1 │                                                       -5.7 │                                                   -5.71428 │
└─────┴─────┴────────────────────────────────────────────────────────────┴────────────────────────────────────────────────────────────┘

divideOrNull

도입 버전: v25.5.0 divide와 동일하지만 0으로 나누면 NULL을 반환합니다. 구문

divideOrNull(x, y)

인수

x — 피제수 - y — 제수

반환 값 x를 y로 나눈 몫 또는 NULL입니다. 예시 0으로 나누기

Query

SELECT divideOrNull(25, 0)

Response

\N

gcd

도입 버전: v1.1.0 두 값 a와 b의 최대공약수를 반환합니다. 0으로 나누거나 가장 작은 음수를 -1로 나누면 예외가 발생합니다. 구문

gcd(x, y)

인수

x — 첫 번째 정수 - y — 두 번째 정수

반환 값 x와 y의 최대공약수입니다. 예시 사용 예시

Query

SELECT gcd(12, 18)

Response

ifNotFinite

도입 버전: v20.3.0 부동소수점 값이 유한한지 검사합니다. 삼항 연산자를 사용하면 유사한 결과를 얻을 수 있습니다: isFinite(x) ? x : y. 구문

ifNotFinite(x,y)

인수

x — 무한인지 확인할 값. Float*
y — 폴백 값. Float*

반환 값

x가 유한하면 x
x가 유한하지 않으면 y

예시 사용 예시

Query

SELECT 1/0 AS infimum, ifNotFinite(infimum,42)

Response

inf  42

intDiv

도입 버전: v1.1.0 두 값 x를 y로 나누는 정수 나눗셈을 수행합니다. 즉, 몫을 내림하여 가장 가까운 작은 정수로 계산합니다. 결과는 피제수(첫 번째 매개변수)와 동일한 비트를 가집니다. 0으로 나누는 경우, 몫이 피제수의 표현 범위에 맞지 않는 경우, 또는 가장 작은 음수를 -1로 나누는 경우 예외가 발생합니다. 구문

intDiv(x, y)

인수

x — 왼쪽 피연산자. - y — 오른쪽 피연산자.

반환 값 x와 y를 정수 나눗셈한 결과 예시 두 개의 float에 대한 정수 나눗셈

Query

SELECT intDiv(toFloat64(1), 0.001) AS res, toTypeName(res)

Response

┌──res─┬─toTypeName(intDiv(toFloat64(1), 0.001))─┐
│ 1000 │ Int64                                   │
└──────┴─────────────────────────────────────────┘

몫이 피제수의 표현 범위를 벗어납니다

Query

SELECT
intDiv(1, 0.001) AS res,
toTypeName(res)

Response

Received exception from server (version 23.2.1):
Code: 153. DB::Exception: Received from localhost:9000. DB::Exception:
Cannot perform integer division, because it will produce infinite or too
large number: While processing intDiv(1, 0.001) AS res, toTypeName(res).
(ILLEGAL_DIVISION)

intDivOrNull

도입 버전: v25.5.0 intDiv와 동일하지만, 0으로 나누거나 가장 작은 음수를 -1로 나누는 경우에는 NULL을 반환합니다. 구문

intDivOrNull(x, y)

인수

x — 왼쪽 피연산자. (U)Int*
y — 오른쪽 피연산자. (U)Int*

반환 값 x를 y로 정수 나눗셈한 결과 또는 NULL입니다. 예시 0으로 나눌 때의 정수 나눗셈

Query

SELECT intDivOrNull(1, 0)

Response

\N

최솟값인 음수를 -1로 나누기

Query

SELECT intDivOrNull(-9223372036854775808, -1)

Response

\N

intDivOrZero

도입 버전: v1.1.0 intDiv와 동일하지만, 0으로 나누거나 가장 작은 음수를 -1로 나눌 경우 0을 반환합니다. 구문

intDivOrZero(a, b)

인수

a — 왼쪽 피연산자. (U)Int*
b — 오른쪽 피연산자. (U)Int*

반환 값 a와 b를 정수 나눗셈한 결과 또는 0입니다. 예시 0으로 나누는 정수 나눗셈

Query

SELECT intDivOrZero(1, 0)

Response

가장 작은 음수를 -1로 나누기

Query

SELECT intDivOrZero(0.05, -1)

Response

isFinite

도입 버전: v1.1.0 Float32 또는 Float64, 또는 BFloat16 인수가 무한대가 아니고 NaN도 아니면 1을 반환하며, 그렇지 않으면 0을 반환합니다. 구문

isFinite(x)

인수

x — 유한한 값인지 확인할 숫자입니다. Float* 또는 BFloat16

반환 값 x가 무한대가 아니고 NaN도 아니면 1이고, 그렇지 않으면 0입니다. 예시 숫자가 유한한지 확인

Query

SELECT isFinite(inf)

Response

isInfinite

도입 버전: v1.1.0 Float32 또는 Float64, 또는 BFloat16 인수가 무한대이면 1을 반환하고, 그렇지 않으면 0을 반환합니다. NaN의 경우에는 0을 반환합니다. 구문

isInfinite(x)

인수

x — 무한 여부를 확인할 숫자입니다. Float* 또는 BFloat16

반환 값 x가 무한대이면 1, 그렇지 않으면 0입니다(NaN인 경우 포함). 예시 숫자가 무한대인지 확인

Query

SELECT isInfinite(inf), isInfinite(NaN), isInfinite(10))

Response

1 0 0

isNaN

도입 버전: v1.1.0 Float32 또는 Float64, 또는 BFloat16 인수가 NaN이면 1을, 그렇지 않으면 0을 반환합니다. 구문

isNaN(x)

인수

x — NaN인지 여부를 평가할 인수입니다. Float* 또는 BFloat16

반환 값 NaN이면 1, 그렇지 않으면 0입니다. 예시 사용 예시

Query

SELECT isNaN(NaN)

Response

lcm

도입 버전: v1.1.0 두 값 x와 y의 최소공배수를 반환합니다. 0으로 나누거나, 표현 가능한 가장 작은 음수를 -1로 나누면 예외가 발생합니다. 구문

lcm(x, y)

인수

x — 첫 번째 정수입니다. (U)Int*
y — 두 번째 정수입니다. (U)Int*

반환 값 x와 y의 최소공배수를 반환합니다. (U)Int* 예시 사용 예시

Query

SELECT lcm(6, 8)

Response

max2

도입 버전: v21.11.0 두 숫자 값 x와 y 중에서 더 큰 값을 반환합니다. 구문

max2(x, y)

인수

x — 첫 번째 값 (U)Int8/16/32/64, Float* 또는 Decimal
y — 두 번째 값 (U)Int8/16/32/64, Float* 또는 Decimal

반환 값 x와 y 중 더 큰 값을 반환합니다. Float64 예시 사용 예시

Query

SELECT max2(-1, 2)

Response

midpoint

도입 버전: v25.11.0 제공된 인수의 평균값을 계산해 반환합니다. 숫자 및 시간 타입을 지원합니다. 구문

midpoint(x1[, x2, ...])

인수

x1[, x2, ...] — 평균을 계산할 단일 값 또는 여러 값을 받습니다.

반환 값 주어진 인수의 평균값을 반환하며, 가장 큰 호환 타입으로 승격됩니다. 예시 숫자 타입

Query

SELECT midpoint(1, toUInt8(3), 0.5) AS result, toTypeName(result) AS type;
-- 반환 유형은 Float64입니다. UInt8이 비교를 위해 64비트로 승격되어야 하기 때문입니다.

Response

┌─result─┬─type────┐
│    1.5 │ Float64 │
└────────┴─────────┘

Decimal 타입

Query

SELECT midpoint(toDecimal32(1.5, 2), toDecimal32(1, 1), 2) AS result, toTypeName(result) AS type;

Response

┌─result─┬─type──────────┐
│    1.5 │ Decimal(9, 2) │
└────────┴───────────────┘

날짜 타입

Query

SELECT midpoint(toDate('2025-01-01'), toDate('2025-01-05')) AS result, toTypeName(result) AS type;

Response

┌─────result─┬─type─┐
│ 2025-01-03 │ Date │
└────────────┴──────┘

DateTime 타입

Query

SELECT midpoint(toDateTime('2025-01-01 00:00:00'), toDateTime('2025-01-03 12:00:00')) AS result, toTypeName(result) AS type;

Response

┌──────────────result─┬─type─────┐
│ 2025-01-02 06:00:00 │ DateTime │
└─────────────────────┴──────────┘

Time64 타입

Query

SELECT midpoint(toTime64('12:00:00', 0), toTime64('14:00:00', 0)) AS result, toTypeName(result) AS type;

Response

┌───result─┬─type──────┐
│ 13:00:00 │ Time64(0) │
└──────────┴───────────┘

min2

도입된 버전: v21.11.0 두 숫자 값 x와 y 중 더 작은 값을 반환합니다. 구문

min2(x, y)

인수

x — 첫 번째 값: (U)Int8/16/32/64, Float* 또는 Decimal
y — 두 번째 값: (U)Int8/16/32/64, Float* 또는 Decimal

반환 값 x와 y 중 더 작은 값을 반환합니다. Float64 예시 사용 예시

Query

SELECT min2(-1, 2)

Response

-1

minus

도입 버전: v1.1.0 두 값 a와 b의 차이를 계산합니다. 결과는 항상 부호 있는 값입니다. plus와 마찬가지로, date 또는 date with time 값에서 정수를 뺄 수 있습니다. 또한 date with time 값 간의 뺄셈도 지원하며, 이 경우 두 값 사이의 시간 차이가 반환됩니다. 구문

minus(x, y)

인수

x — 피감수. - y — 감수.

반환 값 x에서 y를 뺀 값 예시 두 수 빼기

Query

SELECT minus(10, 5)

Response

정수와 날짜의 뺄셈

Query

SELECT minus(toDate('2025-01-01'),5)

Response

2024-12-27

modulo

도입 버전: v1.1.0 두 값 a를 b로 나눈 나머지를 계산합니다. 두 입력이 모두 정수이면 결과 유형은 정수입니다. 입력 중 하나가 부동소수점 수이면 결과 유형은 Float64입니다. 나머지는 C++와 같은 방식으로 계산됩니다. 음수는 버림 나눗셈으로 계산합니다. 0으로 나누거나 가장 작은 음수를 -1로 나누면 예외가 발생합니다. 구문

modulo(a, b)

별칭: mod 인수

a — 피제수 - b — 제수(모듈러스)

반환 값 a % b의 나머지입니다. 예시 사용 예시

Query

SELECT modulo(5, 2)

Response

moduloLegacy

도입 버전: v1.1.0 나눗셈의 나머지를 계산합니다. 이 함수는 C++ % 연산자를 사용하는 레거시 modulo 구현이며, 인수가 음수이면 결과도 음수가 될 수 있습니다. 이 함수는 이전 테이블 파티셔닝 로직과의 하위 호환성을 위해 제공됩니다. 표준 동작이 필요하면 modulo 또는 positiveModulo를 사용하십시오. 구문

moduloLegacy(a, b)

인수

a — 피제수입니다. (U)Int* 또는 Float*
b — 나누는 수입니다. (U)Int* 또는 Float*

반환 값 나눗셈의 나머지를 반환합니다. (U)Int* 또는 Float* 예시 기본 사용법

Query

SELECT moduloLegacy(10, 3)

Response

moduloOrNull

도입 버전: v25.5.0 a를 b로 나눌 때의 나머지를 계산합니다. 함수 modulo와 유사하지만, moduloOrNull은 오른쪽 인수가 0이면 NULL을 반환합니다. 구문

moduloOrNull(x, y)

별칭: modOrNull 인수

x — 피제수입니다. (U)Int* 또는 Float*
y — 제수(모듈러스)입니다. (U)Int* 또는 Float*

반환 값 x를 y로 나눈 나머지를 반환합니다. 제수가 0이면 null을 반환합니다. 예시 제수가 0일 때의 moduloOrNull

Query

SELECT moduloOrNull(5, 0)

Response

\N

moduloOrZero

도입 버전: v20.3.0 modulo와 유사하지만, 나누는 수가 0이면 modulo 함수처럼 예외가 발생하지 않고 0을 반환합니다. 구문

moduloOrZero(a, b)

인수

a — 피제수입니다. (U)Int* 또는 Float*
b — 제수(모듈러스)입니다. (U)Int* 또는 Float*

반환 값 a % b의 나머지를 반환합니다. 제수가 0이면 0을 반환합니다. 예시 사용 예시

Query

SELECT moduloOrZero(5, 0)

Response

multiply

도입 버전: v1.1.0 두 값 x와 y를 곱한 결과를 계산합니다. 구문

multiply(x, y)

인수

x — 곱할 값입니다. (U)Int* 또는 Float* 또는 Decimal
y — 곱할 값입니다. (U)Int* 또는 Float* 또는 Decimal

반환 값 x와 y의 곱을 반환합니다. 예시 두 수를 곱하기

Query

SELECT multiply(5,5)

Response

multiplyDecimal

도입 버전: v22.12.0 두 개의 decimal 값에 대해 곱셈을 수행합니다. 결과 값의 유형은 Decimal256입니다. 결과 스케일은 result_scale 인수(범위 [0, 76]의 상수 Integer)로 명시적으로 지정할 수 있습니다. 지정하지 않으면 결과 스케일은 주어진 인수 중 최대 스케일이 됩니다.

이 함수들은 일반적인 multiply보다 훨씬 느리게 동작합니다. 정밀도를 제어할 필요가 없거나 빠른 계산이 필요하다면 multiply 사용을 고려하십시오.

구문

multiplyDecimal(a, b[, result_scale])

인수

a — 첫 번째 값입니다. Decimal
b — 두 번째 값입니다. Decimal
result_scale — 결과의 scale입니다. (U)Int*

반환 값 지정된 scale로 곱셈한 결과입니다. 유형: Decimal256 예시 사용 예시

Query

SELECT multiplyDecimal(toDecimal256(-12, 0), toDecimal32(-2.1, 1), 1)

Response

25.2

일반 곱셈과의 차이점

Query

SELECT multiplyDecimal(toDecimal256(-12, 0), toDecimal32(-2.1, 1), 1)

Response

┌─multiply(toDecimal64(-12.647, 3), toDecimal32(2.1239, 4))─┐
│                                               -26.8609633 │
└───────────────────────────────────────────────────────────┘
┌─multiplyDecimal(toDecimal64(-12.647, 3), toDecimal32(2.1239, 4))─┐
│                                                         -26.8609 │
└──────────────────────────────────────────────────────────────────┘

Decimal 형 오버플로우

Query

SELECT
    toDecimal64(-12.647987876, 9) AS a,
    toDecimal64(123.967645643, 9) AS b,
    multiplyDecimal(a, b);
SELECT
    toDecimal64(-12.647987876, 9) AS a,
    toDecimal64(123.967645643, 9) AS b,
    a * b;

Response

┌─────────────a─┬─────────────b─┬─multiplyDecimal(toDecimal64(-12.647987876, 9), toDecimal64(123.967645643, 9))─┐
│ -12.647987876 │ 123.967645643 │                                                               -1567.941279108 │
└───────────────┴───────────────┴───────────────────────────────────────────────────────────────────────────────┘
Received exception from server (version 22.11.1):
Code: 407. DB::Exception: Received from localhost:9000. DB::Exception: Decimal math overflow:
While processing toDecimal64(-12.647987876, 9) AS a, toDecimal64(123.967645643, 9) AS b, a * b. (DECIMAL_OVERFLOW)

negate

도입 버전: v1.1.0 인수 x의 부호를 반대로 바꿉니다. 결과는 항상 부호 있는 형식입니다. 구문

negate(x)

인수

x — 부호를 반전할 값입니다.

반환 값 x의 부호를 반전한 값인 -x를 반환합니다. 예시 사용 예시

Query

SELECT negate(10)

Response

-10

plus

도입된 버전: v1.1.0 두 값 x와 y의 합을 계산합니다. 별칭: x + y (연산자)입니다. 정수와 날짜 또는 날짜/시간 값을 더할 수도 있습니다. 전자의 경우 날짜의 일 수가 증가하고, 후자의 경우 날짜/시간 값의 초 수가 증가합니다. 날짜와 시간도 더할 수 있습니다. Date와 Time을 더하면 DateTime이 됩니다. Date와 Time64를 더하거나, Date32와 Time 또는 Time64를 더하면 DateTime64가 됩니다. 구문

plus(x, y)

인수

x — 왼쪽 피연산자. - y — 오른쪽 피연산자.

반환 값 x와 y를 더한 값을 반환합니다 예시 두 숫자 더하기

Query

SELECT plus(5,5)

Response

정수와 날짜 더하기

Query

SELECT plus(toDate('2025-01-01'),5)

Response

2025-01-06

날짜 및 시간 추가

Query

SELECT toDate('2025-01-01') + CAST('14:30:25', 'Time')

Response

2025-01-01 14:30:25

positiveModulo

도입 버전: v22.11.0 x를 y로 나눌 때의 나머지를 계산합니다. modulo 함수와 유사하지만 positiveModulo는 항상 음수가 아닌 값을 반환합니다. 구문

positiveModulo(x, y)

별칭: positive_modulo, pmod 인수

x — 피제수입니다. (U)Int* 또는 Float* 또는 Decimal
y — 제수(모듈러스)입니다. (U)Int* 또는 Float* 또는 Decimal

반환 값 x에서 y로 나누어떨어지는 x 이하의 가장 가까운 정수를 뺀 값을 반환합니다. 예시 사용 예시

Query

SELECT positiveModulo(-1, 10)

Response

positiveModuloOrNull

도입 버전: v25.5.0 a를 b로 나눌 때의 나머지를 계산합니다. 함수 positiveModulo와 유사하지만, positiveModuloOrNull은 오른쪽 인수가 0이면 NULL을 반환합니다. 구문

positiveModuloOrNull(x, y)

별칭: positive_modulo_or_null, pmodOrNull 인수

x — 피제수입니다. (U)Int*/Float32/64. - y — 제수(모듈러스)입니다. (U)Int*/Float32/64.

반환 값 x에서 y로 나누어떨어지는 x 이하의 가장 큰 정수를 뺀 값을 반환합니다. 제수가 0이면 null을 반환합니다. 예시 positiveModuloOrNull

Query

SELECT positiveModuloOrNull(5, 0)

Response

\N

​개요

​abs

​avg2

​byteSwap

​divide

​divideDecimal

​divideOrNull

​gcd

​ifNotFinite

​intDiv

​intDivOrNull

​intDivOrZero

​isFinite

​isInfinite

​isNaN

​lcm

​max2

​midpoint

​min2

​minus

​modulo

​moduloLegacy

​moduloOrNull

​moduloOrZero

​multiply

​multiplyDecimal

​negate

​plus

​positiveModulo

​positiveModuloOrNull

개요

abs

avg2

byteSwap

divide

divideDecimal

divideOrNull

gcd

ifNotFinite

intDiv

intDivOrNull

intDivOrZero

isFinite

isInfinite

isNaN

lcm

max2

midpoint

min2

minus

modulo

moduloLegacy

moduloOrNull

moduloOrZero

multiply

multiplyDecimal

negate

plus

positiveModulo

positiveModuloOrNull