C# Round (jak to działa dla programistów)

Dlaczego zaokraglac liczby?

1. Prostota: Zaokraglone liczby sa często łatwiejsze w odczycie i zrozumieniu.
2. Dokladnosc: W niektorych przypadkach operowanie na zaokraglonych wartosciach zamiast na dokładnych jest bardziej efektywne, szczegółnie w kontekstach takich jak obliczenia walutowe.

Typowe scenariusze zaokraglania

1. Najblizsza liczba całkowita: Zaokraglenie wartosci dziesietnej do najblizszej liczby całkowitej.
2. Określona liczba miejsc dziesiętnych: Zaokrąglenie liczby do określonej liczby miejsc dziesiętnych, na przykład zaokrąglenie 15.678 do dwóch miejsc dziesiętnych będzie 15.68.

Zaokraglanie do najblizszej wartosci całkowitej

Najprostsza forma metody Math.Round zaokrągla wartość typu double do najbliższej wartości całkowitej. Jeśli podana liczba jest rownodystansowa miedzy dwiema liczbami całkowitymi, jest zaokraglana do najblizszej liczby parzystej, często nazywanej "zaokragleniem bankowym".

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}");

Dim originalValue As Double = 4.5
Dim roundedValue As Double = Math.Round(originalValue)
Console.WriteLine($"Original: {originalValue}, Rounded: {roundedValue}")

W powyższym przykładzie 4.5 jest równoważne odległe od 4 i 5. Ponieważ 4 jest najbliższą liczbą parzystą, metoda zwraca 4.

Zaokraglanie do okreslonej liczby miejsc dziesietnych

Można tez zaokraglic liczbe zmiennoprzecinkowa podwojnej precyzji do okreslonej liczby miejsc po przecinku, używając dodatkowego argumentu:

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}");

Dim value As Double = 7.34567
Dim rounded As Double = Math.Round(value, 2) ' Rounds to two decimal places
Console.WriteLine($"Original: {value}, Rounded: {rounded}")

Metoda zaokrągla oryginalną wartość 7.34567 do 7.35, ponieważ określiliśmy, że ma zaokrąglać do dwóch miejsc dziesiętnych.

Domyslne zaokraglanie

Domyślnie Math.Round zaokrągla wartości środkowe do najbliższej liczby parzystej.

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

Dim valueOne As Double = Math.Round(4.5) ' Rounded to 4
Dim valueTwo As Double = Math.Round(5.5) ' Rounded to 6

Określenie trybu MidpointRounding

Aby zapewnić większą kontrolę nad operacją zaokrąglania dla wartości środkowych, możesz przekazać jako parametr określony tryb 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}");

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

W tym przykładzie tryb MidpointRounding.AwayFromZero zapewnia, że liczba zostanie zaokrąglona do 6.

Zaokraglanie w gore

Aby zawsze zaokrąglać w górę do najbliższej liczby całkowitej, można użyć metody 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}");

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

Liczba dziesiętna 4.3 zaokrągla się w górę do 5.

Zaokraglanie w dol

Z kolei zaokrąglenie w dół do najbliższej wartości całkowitej odbywa się za pomocą metody 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}");

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

Liczba dziesiętna 4.7 zaokrągla się w dół do 4.

Parsowanie i zaokraglanie

Oto przykład, jak zaokraglic łańcuch zawierajacy liczbe dziesietna:

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}");

Dim originalString As String = "4.5678"
Dim parsedValue As Double = Double.Parse(originalString)
Dim rounded As Double = Math.Round(parsedValue, 2) ' Rounds to two decimal places
Dim roundedString As String = rounded.ToString()
Console.WriteLine($"Original: {originalString}, Rounded: {roundedString}")

Oryginal: 4.5678, Zaokraglone: 4.57

Przyklad zaokraglania walut

Poniższy przykład pokazuje zaokraglanie wartosci typuu decimal reprezentujacej walute:

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}");

Dim originalValue As Decimal = 1234.5678D
Dim roundedValue As Decimal = Math.Round(originalValue, 2, MidpointRounding.AwayFromZero)
Console.WriteLine($"Original: {originalValue:C}, Rounded: {roundedValue:C}")

Powyższy kod zaokragla wartosc do dwoch miejsc po przecinku, zgodnie z wiekszoscia standardow walutowych.

Czeste problemy

• Precyzja double: Typ double może nie zawsze dokładnie reprezentować liczby dziesiętne, co prowadzi do nieoczekiwanych wyników zaokraglania. Uzycie typu decimal może to złagodzić.
• Niewłaściwy tryb MidpointRounding: Upewnij się, że używasz właściwego trybu MidpointRounding dla swoich specyficznych wymagań. Nieprawidłowe użycie tych trybów może prowadzić do błędów zaokraglania.

Jak debugować

Wykorzystuj narzędzia takie jak logowanie i punkty przerwania, aby śledzić wartość przed i po zaokragleniu. Inspekcja oryginalnej wartosci oraz parametrow przekazanych do metody zaokraglania mogą zazwyczaj ujawnić niespójności.

IronPDF

IronPDF to solidna biblioteka w C#, zaprojektowana do generowania PDF z HTML, edycji i zarządzania. Wyobraz sobie scenariusz, w ktorym musisz generować raport w formacie PDF po wykonaniu operacji zaokraglania. IronPDF może łatwo przekształcić twój kod C# w wysokiej jakosci PDFy.

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.");
    }
}

Imports IronPdf
Imports System

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Sample data for invoice
		Dim itemPrice As Decimal = 49.995D ' Item price before rounding
		Dim taxRate As Decimal = 0.18D ' 18% tax rate

		' Round price to 2 decimal places
		Dim roundedPrice As Decimal = Math.Round(itemPrice, 2)

		' Calculate and round the tax amount
		Dim taxAmount As Decimal = Math.Round(roundedPrice * taxRate, 2)

		' Calculate the total amount
		Dim totalAmount As Decimal = Math.Round(roundedPrice + taxAmount, 2)

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

		' Generate PDF using IronPDF
		Dim renderer = New ChromePdfRenderer()
		Dim pdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

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

		Console.WriteLine("PDF invoice generated successfully with rounded values.")
	End Sub
End Class

IronXL

IronXL zapewnia funkcjonalności do pracy z plikami Excel, umożliwiając programistom C# czytanie, pisanie oraz manipulowanie arkuszami Excel bezproblemowo. Z IronXL, możesz pobierac dane dziesietne lub typu double z arkuszy Excel, wykonywać operacje zaokraglania w C#.

IronOCR

IronOCR to zaawansowana biblioteka optycznego rozpoznawania znakow (OCR) dla C#, która może rozpoznawać i wyodrębniać tekst z obrazów oraz PDFów. Założmy, że masz zeskanowane dokumenty lub obrazy zawierające dane liczbowe. Z IronOCR, możesz wyodrębnić te dane, przetworzyć lub zaokraglic je w C#.

IronBarcode

IronBarcode to potężne narzędzie do generowania, odczytu i klasyfikacji kodów kreskowych oraz kodów QR w .NET. W kontekstach, w ktorych zaokraglone dane muszą być zakodowane do kodów kreskowych (na przykład wyceny produktów w aplikacjach detalicznych), IronBarcode może być nieocenione.