C# Round (開発者向けの仕組み)

なぜ数字を丸めるのですか？

1.シンプルさ:丸められた数字は、読みやすく理解しやすいことがよくあります。 2.精度:特に通貨計算などの状況では、正確な値ではなく丸められた値で演算する方が効率的です。

よくある丸めシナリオ

1.最も近い整数:小数値を最も近い整数に丸めます。 2.指定された小数点以下の桁数:数値を指定された小数点以下の桁数に丸めます。たとえば、15.678 を小数点以下 2 桁に丸める場合は 15.68 になります。

最も近い整数値への丸め

Math.Round メソッドの最も単純な形式は、double 値を最も近い整数値に丸めます。 与えられた数値が二つの整数から等距離の場合、それはしばしば"銀行家の丸め"と呼ばれる最も近い偶数に丸めます。

double originalValue = 4.5;
double roundedValue = Math.Round(originalValue);
Console.WriteLine($"Original: {originalValue}, Rounded: {roundedValue}");

double originalValue = 4.5;
double roundedValue = Math.Round(originalValue);
Console.WriteLine($"Original: {originalValue}, Rounded: {roundedValue}");

上記の例では、4.5 は、4 および 5 から等距離にあります。 4 が最も近い偶数なので、メソッドは 4 を返します。

特定の小数点以下桁数への丸め

追加の引数を使用して、ダブル精度の浮動小数点を指定された小数点以下桁数に丸めることもできます。

double value = 7.34567;
double rounded = Math.Round(value, 2); // Rounds to two decimal places
Console.WriteLine($"Original: {value}, Rounded: {rounded}");

double value = 7.34567;
double rounded = Math.Round(value, 2); // Rounds to two decimal places
Console.WriteLine($"Original: {value}, Rounded: {rounded}");

このメソッドは、小数点以下 2 桁に丸めるように指定しているため、元の値 7.34567 を 7.35 に丸めます。

デフォルトの丸め

デフォルトでは、Math.Round は中間値を最も近い偶数に丸めます。

double valueOne = Math.Round(4.5);  // Rounded to 4
double valueTwo = Math.Round(5.5);  // Rounded to 6

double valueOne = Math.Round(4.5);  // Rounded to 4
double valueTwo = Math.Round(5.5);  // Rounded to 6

MidpointRounding モードの指定

中間値の丸め操作をより細かく制御するには、特定の MidpointRounding モードをパラメータとして渡すことができます。

double value = 5.5;
double rounded = Math.Round(value, 0, MidpointRounding.AwayFromZero);
Console.WriteLine($"Original: {value}, Rounded: {rounded}");

double value = 5.5;
double rounded = Math.Round(value, 0, MidpointRounding.AwayFromZero);
Console.WriteLine($"Original: {value}, Rounded: {rounded}");

この例では、MidpointRounding.AwayFromZero モードにより、数値が 6 に丸められます。

切り上げ

常に最も近い整数に切り上げるには、Math.Ceiling メソッドを使用できます。

double value = 4.3;
double roundedUp = Math.Ceiling(value);
Console.WriteLine($"Original: {value}, Rounded Up: {roundedUp}");

double value = 4.3;
double roundedUp = Math.Ceiling(value);
Console.WriteLine($"Original: {value}, Rounded Up: {roundedUp}");

小数点以下の数値 4.3 は、5 に切り上げられます。

切り捨て

逆に、最も近い整数値に切り捨てるには、Math.Floor メソッドを使用します。

double value = 4.7;
double roundedDown = Math.Floor(value);
Console.WriteLine($"Original: {value}, Rounded Down: {roundedDown}");

double value = 4.7;
double roundedDown = Math.Floor(value);
Console.WriteLine($"Original: {value}, Rounded Down: {roundedDown}");

小数点以下は 4.7 に切り捨てられ、 4 になります。

解析と丸め

小数を含む文字列を丸める例を次に示します：

string originalString = "4.5678";
double parsedValue = double.Parse(originalString);
double rounded = Math.Round(parsedValue, 2); // Rounds to two decimal places
string roundedString = rounded.ToString();
Console.WriteLine($"Original: {originalString}, Rounded: {roundedString}");

string originalString = "4.5678";
double parsedValue = double.Parse(originalString);
double rounded = Math.Round(parsedValue, 2); // Rounds to two decimal places
string roundedString = rounded.ToString();
Console.WriteLine($"Original: {originalString}, Rounded: {roundedString}");

元の値：4.5678, 丸めた値：4.57

貨幣の丸めの例

以下に示す例は、通貨を表す小数値の丸めを示しています：

decimal originalValue = 1234.5678m;
decimal roundedValue = Math.Round(originalValue, 2, MidpointRounding.AwayFromZero);
Console.WriteLine($"Original: {originalValue:C}, Rounded: {roundedValue:C}");

decimal originalValue = 1234.5678m;
decimal roundedValue = Math.Round(originalValue, 2, MidpointRounding.AwayFromZero);
Console.WriteLine($"Original: {originalValue:C}, Rounded: {roundedValue:C}");

上記のコードは、ほとんどの通貨標準に従って値を二桁で丸めます。

よくある落とし穴

*倍精度: double 型では小数点以下の数値が正確に表現されない場合があり、予期しない丸め結果が生じることがあります。 この問題を軽減するためにはdecimal型を使用できます。

• MidpointRounding モードが正しくありません:特定の要件に応じて正しい MidpointRounding モードを使用していることを確認してください。 これらのモードを誤用すると丸めエラーを引き起こす可能性があります。

どうデバッグするか

ログとブレークポイントのようなツールを利用して、丸めの前後の値を追跡します。 丸めメソッドに渡したオリジナルの値とパラメータを調査することは通常、不整合を明らかにできます。

IronPDF

IronPDFは、HTMLからのPDF生成、編集、管理を目的としたC#で開発された強力なライブラリです。 丸め操作を行った後にPDF形式でレポートを生成する必要があるシナリオを想像してください。 IronPDFはC#のコードを高品質のPDFに簡単に変換することができます。

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Sample data for invoice
        decimal itemPrice = 49.995m; // Item price before rounding
        decimal taxRate = 0.18m;     // 18% tax rate

        // Round price to 2 decimal places
        decimal roundedPrice = Math.Round(itemPrice, 2);

        // Calculate and round the tax amount
        decimal taxAmount = Math.Round(roundedPrice * taxRate, 2);

        // Calculate the total amount
        decimal totalAmount = Math.Round(roundedPrice + taxAmount, 2);

        // Create simple HTML content for the PDF
        string htmlContent = $@"
            <h1>Invoice</h1>
            <p>Item Price: ${roundedPrice}</p>
            <p>Tax (18%): ${taxAmount}</p>
            <hr>
            <h2>Total Amount: ${totalAmount}</h2>
        ";

        // Generate PDF using IronPDF
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF file
        pdfDocument.SaveAs("Invoice.pdf");

        Console.WriteLine("PDF invoice generated successfully with rounded values.");
    }
}

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Sample data for invoice
        decimal itemPrice = 49.995m; // Item price before rounding
        decimal taxRate = 0.18m;     // 18% tax rate

        // Round price to 2 decimal places
        decimal roundedPrice = Math.Round(itemPrice, 2);

        // Calculate and round the tax amount
        decimal taxAmount = Math.Round(roundedPrice * taxRate, 2);

        // Calculate the total amount
        decimal totalAmount = Math.Round(roundedPrice + taxAmount, 2);

        // Create simple HTML content for the PDF
        string htmlContent = $@"
            <h1>Invoice</h1>
            <p>Item Price: ${roundedPrice}</p>
            <p>Tax (18%): ${taxAmount}</p>
            <hr>
            <h2>Total Amount: ${totalAmount}</h2>
        ";

        // Generate PDF using IronPDF
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF file
        pdfDocument.SaveAs("Invoice.pdf");

        Console.WriteLine("PDF invoice generated successfully with rounded values.");
    }
}

IronXL

IronXLは、C#開発者がExcelファイルをシームレスに読み書きし、操作するための機能を提供します。 IronXLでは、Excelシートから小数またはダブルデータを取得し、C#で丸め操作を行うことができます。

IronOCR

IronOCRは、画像やPDFからテキストを認識して抽出する先進的なC#用光学文字認識(OCR)ライブラリです。 数値データを含むスキャンされた文書や画像を持っていると仮定します。 IronOCRを使用すると、このデータを抽出し、C#で処理したり丸めたりすることができます。

IronBarcode

IronBarcodeは、.NETでバーコードやQRコードを生成、読み取り、分類するための強力なツールです。 丸められたデータをバーコードにエンコードする必要がある文脈(たとえば、リテールアプリケーションでの製品価格設定)において、IronBarcodeは非常に貴重です。