HOWTO · Csharp
C# で double 値を整数値に丸めます
C# で double 値を整数値に丸めるには、Math.Ceiling()、Math.Floor()、Math.Round() を用途に応じて使い分けます。
このページの内容
double を int に変換するときは、まず丸め規則を選びます。正の無限大の方向へ丸めるには Math.Ceiling()、負の無限大の方向へ丸めるには Math.Floor()、最も近い整数値を選ぶには Math.Round() を使います。(int)value のようなキャストはゼロ方向に小数部を切り捨てる処理であり、丸めではありません。
3つの数学メソッドは整数値になった double を返すため、int が必要な場合は戻り値をキャストします。入力が大きい可能性がある場合は、変換前に結果が int の範囲内か確認してください。
int に変換する前に丸め規則を選ぶ
ゼロの正負どちら側にある値でも、丸める方向が重要です。たとえば、Math.Ceiling(-8.3) は -8 になり、Math.Floor(-8.3) は -9 になります。どちらのメソッドも、単に「小数部を取り除く」処理ではありません。用途に合う操作を次の表から選んでください。
| 操作 | 規則 | 8.3 の結果例 |
-8.3 の結果例 |
|---|---|---|---|
Math.Ceiling(value) |
正の無限大の方向 | 9 |
-8 |
Math.Floor(value) |
負の無限大の方向 | 8 |
-9 |
Math.Round(value) |
最も近い整数。中間値は既定で偶数へ丸める | 8 |
-8 |
(int)value |
ゼロ方向に切り捨て | 8 |
-8 |
この表は変換前の結果を示しています。各数学メソッドの戻り値は double です。入力が整数型の範囲内であれば、明示的に int へキャストしても、これらの整数値はそのまま保たれます。適切な規則は、その整数値の用途によって異なります。個数、上限・下限、最も近い推定値では、それぞれ異なる規則が必要になることがあります。
次の自己完結した例を実行してください。コード内の表示ラベルと出力は英語のままです。
using System;
class Program
{
static void Main()
{
double value = 8.3;
double otherValue = -8.3;
Console.WriteLine($"Ceiling: {(int)Math.Ceiling(value)}, {(int)Math.Ceiling(otherValue)}");
Console.WriteLine($"Floor: {(int)Math.Floor(value)}, {(int)Math.Floor(otherValue)}");
Console.WriteLine($"Nearest: {(int)Math.Round(value)}, {(int)Math.Round(otherValue)}");
Console.WriteLine($"Cast: {(int)value}, {(int)otherValue}");
Console.WriteLine($"Midpoints: {(int)Math.Round(2.5)}, {(int)Math.Round(3.5)}, {(int)Math.Round(2.5, MidpointRounding.AwayFromZero)}");
}
}
Math.Ceiling() で切り上げる
Math.Ceiling() は、入力値以上となる最小の整数値の double を返します。正の無限大の方向への丸めであり、正の小数値は次の整数へ進み、負の小数値はゼロに近い整数へ進みます。戻り値を int にキャストする前に、その値を int で表現できるか確認してください。
元の値より小さくならない結果が必要なときに、この規則を使います。たとえば、ある量を収めるのに必要な容器の個数を求める場合です。Math.Ceiling(7.3) は整数値の double である 8 を返し、(int)Math.Ceiling(7.3) は値が適切な int の範囲内であれば整数になります。要件が「ゼロから遠ざかる方向への丸め」を意味する場合、負の値に対して Ceiling はその規則にはなりません。
Math.Floor() で切り下げる
Math.Floor() は、入力値以下となる最大の整数値の double を返します。負の無限大の方向へ丸めるため、Math.Floor(7.8) は 7、Math.Floor(-7.8) は -8 になります。この違いは重要です。ゼロ未満の値を切り下げる処理は、小数部を単に取り除くことではありません。
結果が入力値を超えてはならない場合に Math.Floor() を使います。たとえば、測定した量に含まれる完全な単位の数を求める場合です。Ceiling と同様、戻り値の double を int に変換するのは、結果が整数型の範囲内に収まる場合に限ってください。正負どちらの場合もゼロ方向に小数部を取り除きたいなら、代わりにキャストまたは Math.Truncate() を使います。
Math.Round() で最も近い整数に丸める
Math.Round() は最も近い整数値を選び、double として返します。既定の中間値規則は偶数丸めです。値が2つの整数のちょうど中間にある場合、偶数のほうを選びます。たとえば、Math.Round(2.5) は 2、Math.Round(3.5) は 4 になります。この規則は、中間値の計算を繰り返したときの方向への偏りを抑えます。
もう一つの一般的な中間値規則を使うには、MidpointRounding.AwayFromZero を渡します。Math.Round(2.5, MidpointRounding.AwayFromZero) は 3、Math.Round(-2.5, MidpointRounding.AwayFromZero) は -3 を選びます。この指定が変えるのは中間値の扱いであり、すべての値をゼロから遠ざかる方向に丸めるわけではありません。必要に応じて、結果が範囲内であることを確認してから int にキャストしてください。
2進浮動小数点数では、一部の10進小数を正確に表現できず、近似値になることがあります。中間値として扱うつもりの値をほかの浮動小数点数から計算した場合、保存された値が中間値よりわずかに大きい、または小さいことがあります。正確な10進数の量に基づく規則が必要な場合は、decimal と対応する Math.Round のオーバーロードを使い、希望する中間値の丸め方を選ぶことを検討してください。
キャストは丸め処理ではない
double から int への明示的な変換では、小数部をゼロ方向に切り捨てます。たとえば、(int)8.9 は 8、(int)(-8.9) は -8 になります。後者は -9 となる Math.Floor(-8.9) と異なり、最も近い整数への丸めとも異なります。最も近い整数への丸めでは、選択した中間値規則に従って近いほうの整数が選ばれます。
切り捨てが意図した処理である場合にキャストを使ってください。「整数に丸める」ための近道として使うものではありません。入力が int の範囲外になる可能性がある場合は、変換前に範囲を明示的に処理してください。そうしないと、アプリケーションが期待する値を表せない結果になることがあります。まとめると、正の無限大の方向へ上限を求めるなら Math.Ceiling()、負の無限大の方向へ下限を求めるなら Math.Floor()、最も近い整数を求めるなら Math.Round()、ゼロ方向への切り捨てならキャストを選びます。