丸め関数

floor

x以下の最大の丸められた数値を返します。
丸められた数は、1 / 10 * Nの倍数、または1 / 10 * Nが正確でない場合は適切なデータ型の最も近い数です。

整数引数は負の N 引数で丸めることができ、非負の N では関数は x を返します。つまり、何もしません。

丸めによってオーバーフローが発生した場合（例: floor(-128, -1)）、結果は未定義です。

構文

floor(x[, N])

パラメータ

x - 丸める値。 Float*、Decimal*、または(U)Int*。
N - (U)Int*。デフォルトはゼロで、整数に丸めることを意味します。負の値でも可能です。

返される値

x と同じ型の丸められた数。

例

クエリ:

SELECT floor(123.45, 1) AS rounded

結果:

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

クエリ:

SELECT floor(123.45, -1)

結果:

┌─rounded─┐
│     120 │
└─────────┘

ceiling

floorに似ていますが、x以上の最小の丸められた数を返します。

構文

ceiling(x[, N])

別名: ceil

truncate

floorに似ていますが、xの絶対値以下であり、最大の絶対値の丸められた数を返します。

構文

truncate(x[, N])

別名: trunc。

例

クエリ:

SELECT truncate(123.499, 1) AS res;

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

round

値を指定された小数点以下の桁数に丸めます。

この関数は、指定された桁数に最も近い数を返します。
入力値が2つの隣接する数値に対して等距離の場合、関数はFloat*入力に対してバンカーズ丸めを使用し、他の数値型（Decimal*）にはゼロから離れる方向で丸めます。

構文

round(x[, N])

引数

x — 丸める数。 Float*、Decimal*、または(U)Int*。
N — 丸める小数点以下の桁数。整数。デフォルトは 0。
- N > 0 の場合、関数は小数点の右側に丸めます。
- N < 0 の場合、関数は小数点の左側に丸めます。
- N = 0 の場合、関数は次の整数に丸めます。

返される値:

x と同じ型の丸められた数。

例

Float入力の例:

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

┌───x─┬─round(divide(number, 2))─┐
│   0 │                        0 │
│ 0.5 │                        0 │
│   1 │                        1 │
└─────┴──────────────────────────┘

Decimal入力の例:

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

┌───x─┬─round(CAST(divide(number, 2), 'Decimal(10, 4)'))─┐
│   0 │                                                0 │
│ 0.5 │                                                1 │
│   1 │                                                1 │
└─────┴──────────────────────────────────────────────────┘

末尾のゼロを保持するには、output_format_decimal_trailing_zerosを有効にします:

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

┌──────x─┬─round(CAST(divide(number, 2), 'Decimal(10, 4)'))─┐
│ 0.0000 │                                           0.0000 │
│ 0.5000 │                                           1.0000 │
│ 1.0000 │                                           1.0000 │
└────────┴──────────────────────────────────────────────────┘

最も近い数への丸めの例:

round(3.2, 0) = 3
round(4.1267, 2) = 4.13
round(22,-1) = 20
round(467,-2) = 500
round(-467,-2) = -500

バンカーズ丸め。

round(3.5) = 4
round(4.5) = 4
round(3.55, 1) = 3.6
round(3.65, 1) = 3.6

関連項目

roundBankers

roundBankers

指定された小数位置に対して数を丸めます。

丸める数が2つの数の間で半分の位置にある場合、関数はバンカーズ丸めを使用します。
バンカーズ丸めは、分数の数値を丸める方法であり、
丸める数が2つの数の間で半分の位置にある場合は、指定された小数位で最も近い偶数の桁に丸められます。
例えば: 3.5は4に丸められ、2.5は2に丸められます。
これは、IEEE 754で定義された浮動小数点数のデフォルトの丸め方法です。
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])

引数

N > 0 — 関数は、数を小数点の右側の指定位置に丸めます。例: roundBankers(3.55, 1) = 3.6。
N < 0 — 関数は、数を小数点の左側の指定位置に丸めます。例: roundBankers(24.55, -1) = 20。
N = 0 — 関数は、数を整数に丸めます。この場合、引数を省略できます。例: roundBankers(2.5) = 2。
x — 丸める数。 Float*、Decimal*、または(U)Int*。
N — 丸める小数点以下の桁数。整数。デフォルトは 0。
- N > 0 の場合、関数は小数点の右側に丸めます。
- N < 0 の場合、関数は小数点の左側に丸めます。
- N = 0 の場合、関数は次の整数に丸めます。

返される値

バンカーズ丸め法で丸められた値。

例

クエリ:

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

結果:

┌───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 │
└─────┴───┘

バンカーズ丸めの例:

roundBankers(0.4) = 0
roundBankers(-3.5) = -4
roundBankers(4.5) = 4
roundBankers(3.55, 1) = 3.6
roundBankers(3.65, 1) = 3.6
roundBankers(10.35, 1) = 10.4
roundBankers(10.755, 2) = 10.76

関連項目

round

roundToExp2

数を受け入れます。数が1未満の場合、0を返します。それ以外の場合は、最も近い（整数の非負の）2の累乗に丸めます。

構文

roundToExp2(num)

パラメータ

num: 丸める数。 UInt/Float。

返される値

0 、num が $1 \lt$ の場合。 UInt8。
num を最も近い（整数の非負の）2の累乗に丸めた結果。 UInt/Float は入力型と等しい。

例

クエリ:

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

結果:

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

roundDuration

数を受け入れます。数が1未満の場合、0を返します。それ以外の場合、一般的に使用される期間の集合からの数に丸めます: 1, 10, 30, 60, 120, 180, 240, 300, 600, 1200, 1800, 3600, 7200, 18000, 36000。

構文

roundDuration(num)

パラメータ

num: 一般的な期間の集合内の一つに丸める数。 UInt/Float。

返される値

0 、num が $1 \lt$ の場合。
それ以外の場合は、次のいずれか: 1, 10, 30, 60, 120, 180, 240, 300, 600, 1200, 1800, 3600, 7200, 18000, 36000。 UInt16。

例

クエリ:

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

結果:

┌─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 │
└────────┴───────────────────────┘

roundAge

一般的に使用される人間の年齢の範囲内の数を受け入れ、その範囲内の最大または最小を返します。

構文

roundAge(num)

パラメータ

age: 年を表す数。 UInt/Float。

返される値

$age \lt 1$ の場合は 0 を返します。
$1 \leq age \leq 17$ の場合は 17 を返します。
$18 \leq age \leq 24$ の場合は 18 を返します。
$25 \leq age \leq 34$ の場合は 25 を返します。
$35 \leq age \leq 44$ の場合は 35 を返します。
$45 \leq age \leq 54$ の場合は 45 を返します。
$age \geq 55$ の場合は 55 を返します。

型: UInt8。

例

クエリ:

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

結果:

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

roundDown

数を受け入れ、指定された配列の要素に丸めます。値が下限未満の場合は、下限が返されます。

構文

roundDown(num, arr)

パラメータ

num: 丸める数。 Numeric。
arr: ageを下げる配列の要素。 Array の UInt/Float 型。

返される値

配列 arr の要素に丸められた数。値が下限未満の場合は下限が返されます。 UInt/Float 型は arrの型から推測されます。

例

クエリ:

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

結果:

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

floor​

ceiling​

truncate​

round​

roundBankers​

roundToExp2​

roundDuration​

roundAge​

roundDown​

floor

ceiling

truncate

round

roundBankers

roundToExp2

roundDuration

roundAge

roundDown