ラウンディング関数

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 $\lt 1$ の場合。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 $\lt 1$ の場合。
• さもなければ、以下のいずれか: 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 │
└────────┴──────────────────────────────┘