반올림 함수

반올림 함수 문서

아래 문서는 system.functions 시스템 테이블에서 자동 생성되었습니다

​

ceil

도입 버전: v1.1.0

floor와 유사하지만, x보다 크거나 같은 값 중 가장 작은 반올림 값을 반환합니다. 반올림으로 인해 오버플로우가 발생하면(예: ceiling(255, -1)), 결과는 정의되지 않습니다.

구문

ceiling(x[, N])

별칭: ceiling

인수

• x — 반올림할 값입니다. Float* 또는 Decimal* 또는 (U)Int*
• N — 선택 사항입니다. 반올림할 소수점 이하 자릿수입니다. 기본값은 0이며, 이 경우 정수로 반올림합니다. 음수일 수 있습니다. (U)Int*

반환 값

x와 동일한 타입의 반올림된 숫자를 반환합니다. Float* 또는 Decimal* 또는 (U)Int*

예시

기본 사용법

Query

SELECT ceiling(123.45, 1) AS rounded

Response

┌─rounded─┐
│   123.5 │
└─────────┘

음수 정밀도

Query

SELECT ceiling(123.45, -1)

Response

┌─ceiling(123.45, -1)─┐
│                 130 │
└─────────────────────┘

​

floor

도입 버전: v1.1.0

x보다 작거나 같은 값 중에서 가장 큰 반올림 값을 반환합니다. 여기서 반올림 값은 1 / 10 * N의 배수이며, 1 / 10 * N을 정확하게 표현할 수 없으면 해당 데이터 타입에서 가장 가까운 값을 반환합니다.

정수 인수는 N 인수가 음수일 때 반올림될 수 있습니다. N이 0 이상이면 함수는 x를 반환합니다.

반올림으로 인해 오버플로우가 발생하면(예: floor(-128, -1)), 결과는 정의되지 않습니다.

구문

floor(x[, N])

인수

• x — 반올림할 값입니다. Float* 또는 Decimal* 또는 (U)Int*
• N — 선택 사항입니다. 반올림할 소수 자릿수입니다. 기본값은 0이며, 이 경우 정수로 반올림합니다. 음수일 수 있습니다. (U)Int*

반환 값

x와 동일한 타입의 반올림된 수를 반환합니다. Float* 또는 Decimal* 또는 (U)Int*

예시

사용 예시

Query

SELECT floor(123.45, 1) AS rounded

Response

┌─rounded─┐
│   123.4 │
└─────────┘

음수 정밀도

Query

SELECT floor(123.45, -1)

Response

┌─floor(123.45, -1)─┐
│               120 │
└───────────────────┘

​

round

도입 버전: v1.1.0

값을 지정된 소수 자릿수 N에 맞춰 반올림합니다.

• N > 0이면 함수는 소수점 오른쪽 자리에서 반올림합니다.
• N < 0이면 함수는 소수점 왼쪽 자리에서 반올림합니다.
• N = 0이면 함수는 가장 가까운 정수로 반올림합니다.

이 함수는 지정된 자릿수에서 가장 가까운 수를 반환합니다. 입력값이 인접한 두 수와 같은 거리에 있으면, 함수는 Float* 입력에 대해 은행가 반올림을 사용하고 다른 숫자 타입(Decimal*)에 대해서는 0에서 멀어지는 방향으로 반올림합니다.

반올림으로 인해 오버플로우가 발생하면(예: round(255, -1)), 결과는 정의되지 않습니다.

구문

round(x[, N])

인수

• x — 반올림할 숫자입니다. Float* 또는 Decimal* 또는 (U)Int*
• N — 선택 사항입니다. 반올림할 소수 자릿수입니다. 기본값은 0입니다. (U)Int*

반환 값

x와 같은 타입의 반올림된 숫자를 반환합니다. Float* 또는 Decimal* 또는 (U)Int*

예시

Float 입력

Query

SELECT number / 2 AS x, round(x) FROM system.numbers LIMIT 3;

Response

┌───x─┬─round(x)─┐
│   0 │        0 │
│ 0.5 │        0 │
│   1 │        1 │
└─────┴──────────┘

Decimal 입력값

Query

SELECT cast(number / 2 AS Decimal(10,4)) AS x, round(x) FROM system.numbers LIMIT 3;

Response

┌───x─┬─round(x)─┐
│   0 │        0 │
│ 0.5 │        1 │
│   1 │        1 │
└─────┴──────────┘

​

roundAge

도입 버전: v1.1.0

사람의 나이를 나타내는 숫자를 받아 표준 연령대와 비교하여, 해당 숫자가 속한 구간의 최댓값 또는 최솟값을 반환합니다.

• age < 1이면 0을 반환합니다.
• 1 ≤ age ≤ 17이면 17을 반환합니다.
• 18 ≤ age ≤ 24이면 18을 반환합니다.
• 25 ≤ age ≤ 34이면 25를 반환합니다.
• 35 ≤ age ≤ 44이면 35를 반환합니다.
• 45 ≤ age ≤ 54이면 45를 반환합니다.
• age ≥ 55이면 55를 반환합니다.

구문

roundAge(num)

인수

• age — 연 단위 나이를 나타내는 숫자입니다. (U)Int* 또는 Float*

반환 값

age가 속한 범위의 최댓값 또는 최솟값에 해당하는 나이를 반환합니다. UInt8

예시

사용 예시

Query

SELECT *, roundAge(*) FROM system.numbers WHERE number IN (0, 5, 20, 31, 37, 54, 72);

Response

┌─number─┬─roundAge(number)─┐
│      0 │                0 │
│      5 │               17 │
│     20 │               18 │
│     31 │               25 │
│     37 │               35 │
│     54 │               45 │
│     72 │               55 │
└────────┴──────────────────┘

​

roundBankers

도입 버전: v20.1.0

숫자를 지정된 소수 자릿수 N으로 반올림합니다. 반올림 대상 숫자가 두 수의 정확한 중간값이면, 이 함수는 IEEE 754에서 부동소수점 수의 기본 반올림 방식으로 정의된 은행가 반올림 방식을 사용합니다.

• N > 0이면 함수는 소수점 오른쪽 자리에서 반올림합니다
• N < 0이면 함수는 소수점 왼쪽 자리에서 반올림합니다
• N = 0이면 함수는 가장 가까운 정수로 반올림합니다

• 반올림 대상 숫자가 두 수의 정확한 중간값이면, 지정한 자릿수에서 가장 가까운 짝수로 반올림됩니다. 예를 들어 3.5는 올림되어 4가 되고, 2.5는 내림되어 2가 됩니다.
• round 함수도 부동소수점 수에 대해 동일한 방식으로 반올림합니다.
• roundBankers 함수는 정수도 같은 방식으로 반올림합니다. 예를 들어 roundBankers(45, -1) = 40입니다.
• 그 밖의 경우에는 숫자를 가장 가까운 정수로 반올림합니다.

은행가 반올림을 사용하면 숫자를 반올림할 때 합계나 차의 결과에 미치는 영향을 줄일 수 있습니다.

예를 들어 숫자 1.5, 2.5, 3.5, 4.5를 서로 다른 방식으로 반올림해 더하면 다음과 같습니다.

• 반올림하지 않음: 1.5 + 2.5 + 3.5 + 4.5 = 12.
• 은행가 반올림: 2 + 2 + 4 + 4 = 12.
• 가장 가까운 정수로 반올림: 2 + 3 + 4 + 5 = 14.

구문

roundBankers(x[, N])

인수

• x — 반올림할 숫자입니다. (U)Int* 또는 Decimal* 또는 Float*
• [, N] — 선택 사항입니다. 반올림할 소수 자릿수입니다. 기본값은 0입니다. (U)Int*

반환 값

은행가 반올림 방식으로 반올림한 값을 반환합니다. (U)Int* 또는 Decimal* 또는 Float*

예시

기본 사용법

Query

SELECT number / 2 AS x, roundBankers(x, 0) AS b FROM system.numbers LIMIT 10

Response

┌───x─┬─b─┐
│   0 │ 0 │
│ 0.5 │ 0 │
│   1 │ 1 │
│ 1.5 │ 2 │
│   2 │ 2 │
│ 2.5 │ 2 │
│   3 │ 3 │
│ 3.5 │ 4 │
│   4 │ 4 │
│ 4.5 │ 4 │
└─────┴───┘

​

roundDown

도입 버전: v20.1.0

숫자를 지정된 배열의 요소 중 하나에 맞춰 내림합니다. 값이 하한보다 작으면 하한이 반환됩니다.

구문

roundDown(num, arr)

인수

• num — 내림할 숫자입니다. (U)Int* 또는 Decimal* 또는 Float*
• arr — num을 내림할 기준이 되는 요소의 배열입니다. Array((U)Int*) 또는 Array(Float*)

반환 값

arr의 요소 중 하나로 내림된 숫자를 반환합니다. 값이 최솟값보다 작으면 최솟값을 반환합니다. (U)Int* 또는 Float*

예시

사용 예시

Query

SELECT *, roundDown(*, [3, 4, 5]) FROM system.numbers WHERE number IN (0, 1, 2, 3, 4, 5)

Response

┌─number─┬─roundDown(number, [3, 4, 5])─┐
│      0 │                            3 │
│      1 │                            3 │
│      2 │                            3 │
│      3 │                            3 │
│      4 │                            4 │
│      5 │                            5 │
└────────┴──────────────────────────────┘

​

roundDuration

도입 버전: v1.1.0

숫자를 일반적으로 사용되는 지속 시간 값 집합 1, 10, 30, 60, 120, 180, 240, 300, 600, 1200, 1800, 3600, 7200, 18000, 36000 중에서 가장 가까운 더 작은 값으로 내림합니다. 숫자가 1보다 작으면 0을 반환합니다.

구문

roundDuration(num)

인수

• num — 일반적으로 사용되는 기간 값 집합의 값 중 하나로 반올림할 숫자입니다. (U)Int* 또는 Float*

반환 값

num < 1이면 0을 반환합니다. 그렇지 않으면 다음 값 중 하나를 반환합니다. 1, 10, 30, 60, 120, 180, 240, 300, 600, 1200, 1800, 3600, 7200, 18000, 36000. UInt16

예시

사용 예시

Query

SELECT *, roundDuration(*) FROM system.numbers WHERE number IN (0, 9, 19, 47, 101, 149, 205, 271, 421, 789, 1423, 2345, 4567, 9876, 24680, 42573)

Response

┌─number─┬─roundDuration(number)─┐
│      0 │                     0 │
│      9 │                     1 │
│     19 │                    10 │
│     47 │                    30 │
│    101 │                    60 │
│    149 │                   120 │
│    205 │                   180 │
│    271 │                   240 │
│    421 │                   300 │
│    789 │                   600 │
│   1423 │                  1200 │
│   2345 │                  1800 │
│   4567 │                  3600 │
│   9876 │                  7200 │
│  24680 │                 18000 │
│  42573 │                 36000 │
└────────┴───────────────────────┘

​

roundToExp2

도입 버전: v1.1.0

숫자를 가장 가까운 (음이 아닌 정수인) 2의 거듭제곱으로 내림합니다. 숫자가 1보다 작으면 0을 반환합니다.

구문

roundToExp2(num)

인수

• num — 내림할 숫자입니다. (U)Int* 또는 Float*

반환 값

num을 가장 가까운 2의 거듭제곱(0 이상의 정수)으로 내림한 값을 반환합니다. num < 1이면 0을 반환합니다. (U)Int* 또는 Float*

예시

사용 예시

Query

SELECT *, roundToExp2(*) FROM system.numbers WHERE number IN (0, 2, 5, 10, 19, 50)

Response

┌─number─┬─roundToExp2(number)─┐
│      0 │                   0 │
│      2 │                   2 │
│      5 │                   4 │
│     10 │                   8 │
│     19 │                  16 │
│     50 │                  32 │
└────────┴─────────────────────┘

​

trunc

도입 버전: v1.1.0

floor와 비슷하지만, 절대값이 x의 절대값보다 작거나 같으면서 그중 가장 큰 반올림된 수를 반환합니다.

구문

truncate(x[, N])

별칭: truncate

인수

• x — 반올림할 값입니다. Float* 또는 Decimal* 또는 (U)Int*
• N — 선택 사항입니다. 반올림할 소수점 이하 자릿수입니다. 기본값은 0이며, 이 경우 정수로 반올림됩니다. (U)Int*

반환 값

x와 동일한 타입의 반올림된 값을 반환합니다. Float* 또는 Decimal* 또는 (U)Int*

예시

기본 사용법

Query

SELECT truncate(123.499, 1) AS res;

Response

┌───res─┐
│ 123.4 │
└───────┘