数値関数 ​

数値関数は数値を丸め、数値をテストします。丸め関数は、1セント未満の差分で会計合計が異なる場合など、システム間の精度の不一致を防ぐのに役立ちます。

整数に丸める ​

次の関数は、数値を最も近い整数、次の整数、または前の整数に丸めます。

round ​

最も近い整数に丸めます。

round(number)

round(3.5)

4

round(2.4)

2

ceil ​

次の整数に切り上げます。

ceil(number)

ceil(3.2)

4

floor ​

前の整数に切り下げます。

floor(number)

floor(3.9)

3

精度に丸める ​

次の関数は、Decimalを固定の小数点以下の桁数または有効桁数に丸めます。

round_places ​

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

round_places(decimal, places, options)

認識されないオプションキーは無視されず、E222を発生させます。

round_places(Decimal('11.545'), 2)

11.55

round_places(Decimal('11.545'), 2, {mode: 'half_even'})

11.54

round_places(Decimal('11.545'), 2, {mode: 'floor'})

11.54

round_significant ​

Decimalを、小数点以下の桁数ではなく有効桁数に丸めます。パディングは行いません。

round_significant(decimal, digits, options)

round_significant(Decimal('1234.5'), 3)

1230

ユースケース: 各請求書明細をセント単位に丸める ​

単価は小数点以下3桁で届きますが、宛先の会計システムでは2桁のみ受け付けます。 round_placesを使用して、各請求書明細を小数点以下2桁に丸めます。

入力

{
  "lines": [
    {"sku": "WID-1", "unit_price": "12.335", "qty": 3},
    {"sku": "GAD-7", "unit_price": "99.005", "qty": 1}
  ]
}

Formula

_.lines >> map_by(l ~> {
  sku: l.sku,
  total: round_places(Decimal(l.unit_price) * l.qty, 2)
})

出力

[
  {"sku": "WID-1", "total": 37.01},
  {"sku": "GAD-7", "total": 99.01}
]

価格は最初からDecimalのまま保持されるため、乗算は正確で、最後の丸めでのみ何らかの損失が発生します。代わりに最初にFloat読み取りを行うと、2回丸めが行われ、2回目の丸めはすでに近似値になっている数値に適用されます。

絶対値 ​

次の関数は、符号を破棄して数値の大きさを返します。

abs ​

符号を破棄して、数値の大きさを返します。 Durationも受け付けます。

abs(value)

abs(-42)

42

数値をテストする ​

次の関数は、通常の数値と特別なFloat値を区別します。数値以外の引数は、falseを返すのではなくE100を発生させます。

finite? ​

通常の数値であるInteger、Decimal、またはFloatの場合、trueを返します。

finite?(number)

finite?(1.0)

true

finite?(Float('Infinity'))

false

infinite? ​

値が正の無限大または負の無限大の場合、trueを返します。

infinite?(number)

infinite?(Float('Infinity'))

true

nan? ​

値がFloatの"数値ではない"である場合、trueを返します。

nan?(number)

nan?(1.0)

false

ビット幅 ​

次の関数は、整数の表現に必要なビット数を測定します。

int_bit_size ​

ビット補数エンコードで整数を表現するために必要なビット数を返します。

int_bit_size(integer)

int_bit_size(255)

9

関連情報 ​

• 変換関数: 各データ型を構築する方法。
• 書式設定関数: 表示用に数値をレンダリングします。
• データ型: DecimalとFloatの動作が異なる理由。
• 共通関数: present?およびpresenceに関する情報。
• 時間関数: absも受け付けるDurationに関する情報。