C# Round (Cómo funciona para desarrolladores)

¿Por qué números redondos?

1. Simplicidad: los números redondeados suelen ser más fáciles de leer y comprender.
2. Precisión: En algunos casos, operar con valores redondeados en lugar de exactos es más eficiente, especialmente en contextos como los cálculos de divisas.

Escenarios comunes de redondeo

1. Entero más cercano: redondea un valor decimal a su número entero más cercano.
2. Número específico de decimales: redondea un número a un número específico de decimales, como redondear 15.678 a dos decimales sería 15.68.

Redondear a la integral más próxima

La forma más simple del método Math.Round redondea un valor doble al valor integral más cercano. Si el número dado está equidistante de dos enteros, redondea al número par más cercano, a menudo llamado "redondeo del banquero".

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

En el ejemplo anterior, 4.5 es equidistante de 4 y 5. Dado que 4 es el número par más cercano, el método devuelve 4.

Redondear a un número específico de decimales

También puedes redondear un número de punto flotante de doble precisión a un número específico de decimales utilizando un argumento adicional:

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

El método redondea el valor original 7.34567 a 7.35 ya que lo hemos especificado para redondearlo a dos decimales.

Redondeo por defecto

De forma predeterminada, Math.Round redondea los valores de punto medio al número par más cercano.

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

Especificación de un modo MidpointRounding

Para proporcionar más control sobre la operación de redondeo de valores de punto medio, puede pasar un modo MidpointRounding específico como parámetro:

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

En este ejemplo, el modo MidpointRounding.AwayFromZero asegura que el número se redondee a 6.

Redacción

Para redondear siempre al entero más cercano, puedes utilizar el método 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}");

El número decimal 4.3 se redondea a 5.

Redacción

Por el contrario, el redondeo hacia abajo hasta el valor integral más cercano se realiza utilizando el método 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}");

El número decimal 4.7 se redondea hacia abajo a 4.

Parificación y redondeo

Aquí tienes un ejemplo de cómo redondear una cadena que contiene un número decimal:

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

Original: 4.5678, Redondeado: 4.57

Ejemplo de redondeo de moneda

El siguiente ejemplo demuestra el redondeo de un valor decimal que representa moneda:

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

El código anterior redondea el valor a dos decimales, manteniéndose en línea con la mayoría de los estándares de moneda.

Trampas comunes

• Doble precisión: el tipo doble podría no siempre representar números decimales con exactitud, lo que genera resultados de redondeo inesperados. Usar el tipo decimal puede mitigar esto.
• Modo de redondeo de punto medio incorrecto: asegúrese de utilizar el modo MidpointRounding correcto para sus requisitos específicos. El mal uso de estos modos puede dar lugar a errores de redondeo.

Cómo depurar

Utiliza herramientas como el registro y los puntos de interrupción para rastrear el valor antes y después del redondeo. Inspeccionar el valor original y los parámetros pasados al método de redondeo generalmente puede revelar inconsistencias.

IronPDF

IronPDF es una biblioteca robusta en C# diseñada para la generación de PDF desde HTML, edición y gestión. Imagina un escenario donde necesitas generar un informe en formato PDF tras realizar operaciones de redondeo. IronPDF puede convertir sin esfuerzo tu código C# en PDFs de alta calidad.

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 proporciona funcionalidades para trabajar con archivos Excel, permitiendo a los desarrolladores C# leer, escribir y manipular hojas de Excel sin problemas. Con IronXL, puedes recuperar datos decimales o dobles de hojas de Excel, realizar operaciones de redondeo en C#.

IronOCR

IronOCR es una biblioteca avanzada de Reconocimiento Óptico de Caracteres (OCR) para C# que puede reconocer y extraer texto de imágenes y PDFs. Supón que tienes documentos escaneados o imágenes que contienen datos numéricos. Con IronOCR, puedes extraer estos datos, procesarlos o redondearlos en C#.

IronBarcode

IronBarcode es una herramienta poderosa para generar, leer y clasificar códigos de barras y códigos QR en .NET. En contextos donde los datos redondeados necesitan ser codificados en códigos de barras (por ejemplo, precios de productos en una aplicación minorista), IronBarcode puede ser invaluable.