HOWTO · Csharp

Redondear un valor doble a un valor entero en C#

Hay tres métodos principales para redondear un valor `double` a un entero en C#: `Math.Ceiling()`, `Math.Floor()` y `Math.Round()`.

En esta página

Al convertir un double a int, elige primero la regla de redondeo. Usa Math.Ceiling() para avanzar hacia el infinito positivo, Math.Floor() para avanzar hacia el infinito negativo y Math.Round() para elegir el valor entero más cercano. Una conversión explícita como (int)value trunca hacia cero; no redondea.

Los tres métodos matemáticos devuelven un double con valor entero, así que convierte su resultado cuando necesites un int. Si las entradas pueden ser grandes, comprueba que el resultado esté dentro del rango de int antes de convertirlo.

Elige una regla de redondeo antes de convertir a int

La dirección importa para los valores a ambos lados de cero. Por ejemplo, Math.Ceiling(-8.3) avanza a -8, mientras que Math.Floor(-8.3) avanza a -9. Ninguno de estos métodos significa simplemente «eliminar la parte fraccionaria». Usa esta comparación para elegir la operación que corresponda a tu aplicación:

Operación Regla Resultado de ejemplo para 8.3 Resultado de ejemplo para -8.3
Math.Ceiling(value) Hacia el infinito positivo 9 -8
Math.Floor(value) Hacia el infinito negativo 8 -9
Math.Round(value) Entero más cercano; por defecto, los empates en el punto medio se redondean al par 8 -8
(int)value Truncamiento hacia cero 8 -8

La tabla muestra el resultado antes de la conversión; cada método matemático devuelve un double. Una conversión explícita a int conserva estos valores enteros si la entrada está dentro del rango del tipo. La elección adecuada depende de lo que represente el entero: para contar, establecer un límite o calcular una estimación cercana puede convenir una regla distinta.

Ejecuta este ejemplo autocontenido. Muestra resultados para cada regla y para varios puntos medios; las etiquetas Ceiling, Floor, Nearest, Cast y Midpoints permanecen en inglés porque el bloque de código se conserva sin cambios:

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

Redondear hacia arriba con Math.Ceiling()

Math.Ceiling() devuelve el menor double con valor entero que sea mayor o igual que la entrada. Esto equivale a redondear hacia el infinito positivo: un valor positivo con parte fraccionaria avanza al entero siguiente, mientras que uno negativo con parte fraccionaria pasa al entero más cercano a cero. Convierte el resultado a int solo después de comprobar que puede representarse como un int.

Usa esta regla cuando el resultado nunca deba ser menor que el valor original, por ejemplo, para calcular cuántos recipientes enteros se necesitan para contener una cantidad. Por ejemplo, Math.Ceiling(7.3) produce el double con valor entero 8; (int)Math.Ceiling(7.3) genera un entero si el valor está dentro del rango adecuado de int. Si lo que necesitas es «redondear alejándose de cero», Ceiling no aplica esa regla a los valores negativos.

Redondear hacia abajo con Math.Floor()

Math.Floor() devuelve el mayor double con valor entero que sea menor o igual que la entrada. Redondea hacia el infinito negativo. Por tanto, Math.Floor(7.8) produce 7 y Math.Floor(-7.8) produce -8. La distinción es importante: aplicar el suelo a un valor negativo no se limita a descartar sus cifras fraccionarias.

Usa Math.Floor() cuando el resultado no deba superar el valor de entrada, por ejemplo, al calcular el número de unidades completas de una cantidad medida. Al igual que con Ceiling, convierte el double devuelto a int solo si el resultado cabe en el rango de enteros. Si quieres descartar la parte fraccionaria hacia cero en ambos sentidos, usa una conversión explícita o Math.Truncate().

Redondear al entero más cercano con Math.Round()

Math.Round() selecciona el valor entero más cercano y lo devuelve como double. La regla predeterminada para los puntos medios es redondear al par: cuando un valor está exactamente a mitad de camino entre dos enteros, elige el par. Por ejemplo, Math.Round(2.5) elige 2, mientras que Math.Round(3.5) elige 4. Esto reduce el sesgo direccional al realizar cálculos repetidos con puntos medios.

Para elegir la otra regla habitual para los empates, pasa MidpointRounding.AwayFromZero: Math.Round(2.5, MidpointRounding.AwayFromZero) elige 3 y Math.Round(-2.5, MidpointRounding.AwayFromZero) elige -3. Esta opción modifica el tratamiento de los puntos medios; no hace que todos los valores se redondeen alejándose de cero. Convierte el resultado redondeado a int cuando lo necesites y esté dentro del rango.

Los valores de punto flotante binario solo pueden representar algunos decimales de forma aproximada. Si se pretende que un valor sea exactamente un punto medio, pero se calculó a partir de otros valores de punto flotante, el valor almacenado podría quedar ligeramente a uno u otro lado del punto medio. Si las reglas dependen de cantidades decimales exactas, considera representar esos valores con decimal y usar la sobrecarga correspondiente de Math.Round, sin dejar de elegir el modo de redondeo de puntos medios que necesitas.

Por qué una conversión explícita no redondea

Una conversión explícita de double a int trunca la parte fraccionaria hacia cero. Por ejemplo, (int)8.9 se convierte en 8 y (int)(-8.9) se convierte en -8. El segundo resultado difiere de Math.Floor(-8.9), que da -9, y del redondeo al entero más cercano, que elige el entero más próximo según la regla de puntos medios seleccionada.

Usa una conversión explícita cuando lo que buscas sea truncar, no como atajo para «redondear a un entero». Si la entrada puede quedar fuera del rango de int, gestiona ese rango expresamente antes de convertirla; de lo contrario, el resultado quizá no represente el valor que espera tu aplicación. En resumen, elige Math.Ceiling() para establecer un límite hacia el infinito positivo, Math.Floor() para establecerlo hacia el infinito negativo, Math.Round() para obtener el entero más cercano y una conversión explícita solo para truncar hacia cero.