ラウンディング関数
floor
x
以下の最も大きい丸められた数を返します。
丸められた数は 1 / 10 * N の倍数、または 1 / 10 * N が正確でない場合は適切なデータ型の最も近い数です。
整数引数は負の N
引数で丸めることができます。非負の N
の場合、関数は x
を返し、つまり何もしません。
丸めがオーバーフローを引き起こす場合(例えば floor(-128, -1)
)、結果は未定義です。
構文
パラメータ
返される値
x
と同じ型の丸められた数。
例
クエリ:
結果:
クエリ:
結果:
ceiling
floor
のように、しかし x
以上の最も小さい丸められた数を返します。
構文
エイリアス: ceil
truncate
floor
のように、しかし x
の絶対値以下の絶対値を持つ最も大きい丸められた数を返します。
構文
エイリアス: trunc
。
例
クエリ:
round
値を指定された小数点以下の桁数に丸めます。
入力値が隣接する2つの数の間の等距離にある場合、関数は Float* 入力に対してバンカーの丸めを使用し、他の数値型(Decimal*)に対してはゼロから離れるように丸めます。
構文
引数
x
— 丸める数。Float*、Decimal*、または(U)Int*。N
— 丸める小数点以下の桁数。整数。デフォルトは0
。N > 0
の場合、関数は小数点の右側に丸めます。N < 0
の場合、関数は小数点の左側に丸めます。N = 0
の場合、関数は次の整数に丸めます。
返される値:
x
と同じ型の丸められた数。
例
Float
入力の例:
Decimal
入力の例:
末尾のゼロを保持するには、設定 output_format_decimal_trailing_zeros
を有効にします:
最も近い数への丸めの例:
バンカーの丸め。
関連項目
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。
構文
引数
-
N > 0
— 関数は数を小数点の右側の指定された位置で丸めます。例:roundBankers(3.55, 1) = 3.6
。 -
N < 0
— 関数は数を小数点の左側の指定された位置で丸めます。例:roundBankers(24.55, -1) = 20
。 -
N = 0
— 関数は数を整数に丸めます。この場合、引数を省略することができます。例:roundBankers(2.5) = 2
。 -
N
— 丸める小数点以下の桁数。整数。デフォルトは0
。N > 0
の場合、関数は小数点の右側に丸めます。N < 0
の場合、関数は小数点の左側に丸めます。N = 0
の場合、関数は次の整数に丸めます。
返される値
バンカーの丸め方式で丸められた値。
例
クエリ:
結果:
バンカーの丸めの例:
関連項目
roundToExp2
数を受け入れます。数が1未満の場合、0
を返します。さもなければ、最も近い(整数の非負の)2のべきに丸めます。
構文
パラメータ
返される値
例
クエリ:
結果:
roundDuration
数を受け入れます。数が1未満の場合、0
を返します。さもなければ、一般的に使用される期間のセットからの数に丸めます: 1, 10, 30, 60, 120, 180, 240, 300, 600, 1200, 1800, 3600, 7200, 18000, 36000
。
構文
パラメータ
返される値
0
、num
の場合。- さもなければ、以下のいずれか:
1, 10, 30, 60, 120, 180, 240, 300, 600, 1200, 1800, 3600, 7200, 18000, 36000
。UInt16。
例
クエリ:
結果:
roundAge
さまざまな一般的に使用される人間の年齢範囲内の数を受け入れ、その範囲内の最大または最小を返します。
構文
パラメータ
返される値
- の場合は
0
を返します。 - の場合は
17
を返します。 - の場合は
18
を返します。 - の場合は
25
を返します。 - の場合は
35
を返します。 - の場合は
45
を返します。 - の場合は
55
を返します。
型: UInt8。
例
クエリ:
結果:
roundDown
数を受け入れ、指定された配列の要素に丸めます。値が最小限界より小さい場合は、最小限界が返されます。
構文
パラメータ
返される値
例
クエリ:
結果: