丸め関数

注記

このドキュメントは 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*

例

基本的な使い方

SELECT ceiling(123.45, 1) AS rounded

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

負の精度指定

SELECT ceiling(123.45, -1)

┌─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*

例

使用例

SELECT floor(123.45, 1) AS rounded

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

精度が負の場合

SELECT floor(123.45, -1)

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

round

導入バージョン: v1.1.0

値を、小数点以下の指定した桁数 N に丸めます。

N > 0 の場合、小数点より右側を丸めます。
N < 0 の場合、小数点より左側を丸めます。
N = 0 の場合、最も近い整数に丸めます。

この関数は、指定した桁の位で最も近い数値を返します。入力値が2つの隣接する数値から等距離にある場合、Float* 型の入力に対しては銀行家の丸めを使用し、その他の数値型 (Decimal*) に対してはゼロから遠ざかる方向に丸めます。

丸めによってオーバーフローが発生する場合 (例: round(255, -1)) 、結果は未定義です。

構文

round(x[, N])

引数

x — 丸める対象の数値。Float* または Decimal* または (U)Int*
N — 省略可能。丸める小数桁数。デフォルトは 0。(U)Int*

戻り値

x と同じ型の丸められた数値を返します。Float* または Decimal* または (U)Int*

例

Float 型の入力

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

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

小数入力

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

┌───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

例

使用例

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

roundBankers

導入バージョン: v20.1.0

数値を指定した小数桁数 N に丸めます。丸める値がちょうど 2 つの値の中間にある場合、この関数は banker's rounding と呼ばれる丸め方法を使用します。これは IEEE 754 で定義されている浮動小数点数のデフォルトの丸め方法です。

N > 0 の場合、小数点以下 N 桁に丸めます
N < 0 の場合、小数点より左側 (整数部) を N の位で丸めます
N = 0 の場合、最も近い整数に丸めます

Notes

丸める値がちょうど 2 つの値の中間にある場合、指定した小数桁において最も近い偶数の桁に丸められます。例: 3.5 は 4 に切り上げ、2.5 は 2 に切り下げます。
round 関数は、浮動小数点数に対して同じ丸め方を行います。
roundBankers 関数は整数に対しても同様の丸めを行います。例えば roundBankers(45, -1) = 40 となります。
それ以外の場合、この関数は最も近い整数に丸めます。

合計や減算には banker's rounding を使用する

banker's rounding を使用すると、数値を合計または減算した結果に対する丸めの影響を小さくできます。

例えば、数値 1.5, 2.5, 3.5, 4.5 を異なる丸め方で合計すると次のようになります:

丸めなし: 1.5 + 2.5 + 3.5 + 4.5 = 12
Banker's rounding: 2 + 2 + 4 + 4 = 12
四捨五入で最も近い整数に丸める場合: 2 + 3 + 4 + 5 = 14

構文

roundBankers(x[, N])

引数

x — 丸める数値。(U)Int* または Decimal* または Float*
[, N] — オプション。丸める小数点以下の桁数。デフォルトは 0。(U)Int*

戻り値

banker's rounding (銀行家の丸め) 手法で丸められた値を返します。(U)Int* または Decimal* または Float*

例

基本的な使い方

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

roundDown

導入バージョン: v20.1.0

数値を、指定された配列内の要素のうちそれ以下で最大の値に切り下げます。値が配列の下限値より小さい場合は、その下限値が返されます。

構文

roundDown(num, arr)

引数

num — 切り捨てる数値。(U)Int* または Decimal* または Float*
arr — num を切り捨てる先となる要素の配列。Array((U)Int*) または Array(Float*)

戻り値

arr のいずれかの要素に切り捨てられた数値を返します。値が最小の境界値より小さい場合は、その最小の境界値が返されます。(U)Int* または Float*

例

使用例

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

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

例

使用例

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

roundToExp2

導入バージョン: v1.1.0

数値を、直前の (非負整数の) 2 の冪に切り下げます。数値が 1 未満の場合は 0 を返します。

構文

roundToExp2(num)

引数

num — 丸め対象の数値。(U)Int* または Float*

戻り値

num を、それ以下で最大の (2 の非負整数乗である) 値に切り捨てて返します。num < 1 の場合は 0 を返します。(U)Int* または 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 │
└────────┴─────────────────────┘

trunc

導入バージョン: v1.1.0

floor に似ていますが、x の絶対値以下で、絶対値が最大となるように丸めた数値を返します。

構文

truncate(x[, N])

エイリアス: truncate

引数

x — 丸め対象の値。Float* または Decimal* または (U)Int*
N — 省略可能。丸める小数点以下の桁数。デフォルトは 0 で、この場合は整数への丸めになります。(U)Int*

戻り値

x と同じ型の丸められた数値を返します。Float* または Decimal* または (U)Int*

使用例

基本的な使い方

SELECT truncate(123.499, 1) AS res;

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

ceil​

floor​

round​

roundAge​

roundBankers​

roundDown​

roundDuration​

roundToExp2​

trunc​

ceil

floor

round

roundAge

roundBankers

roundDown

roundDuration

roundToExp2

trunc