Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

MidpointRounding: elegir una regla de redondeo

MidpointRounding especifica una regla de redondeo. ToEven y AwayFromZero eligen el resultado más cercano, pero resuelven de forma distinta los valores que están exactamente a medio camino entre dos resultados posibles.

Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxis

Math.Round(value, digits, MidpointRounding.ToEven)
Math.Round(value, digits, MidpointRounding.AwayFromZero)

MidpointRounding es una enumeración del espacio de nombres System, disponible en .NET 10. Pásala, por ejemplo, a una sobrecarga como Math.Round(value, digits, mode), donde digits indica el número de posiciones decimales. Es una API de biblioteca, no una característica de sintaxis de C# que requiera LangVersion=preview.

MidpointRounding.ToEven resuelve un empate eligiendo el resultado cuya última cifra conservada es par: con digits = 0, 2.5m da 2 y 3.5m da 4. Esto se llama redondeo bancario y es el comportamiento predeterminado de las sobrecargas de Math.Round que no incluyen un parámetro de modo de redondeo. MidpointRounding.AwayFromZero resuelve un empate eligiendo el resultado más alejado de cero: 2.5m da 3 y -2.5m da -3.

Fuera de los empates, ambos modos eligen el resultado más cercano: 2.1m da 2 en los dos casos. Por tanto, AwayFromZero no siempre aumenta el valor absoluto. Con una cifra decimal, 3.45m está a medio camino, pero 3.451m no. Los otros modos —ToZero, ToNegativeInfinity y ToPositiveInfinity— redondean todos los valores en una dirección determinada, no solo los que están a medio camino.

El resultado depende del valor que realmente está almacenado. La representación binaria de double puede hacer que un valor que parece estar a medio camino en decimal no sea un empate. El ejemplo utiliza literales decimal con el sufijo m para representar exactamente los valores mostrados y CultureInfo.InvariantCulture para fijar el formato de salida.

Ejemplos

using System;
using System.Globalization;

CultureInfo.CurrentCulture = CultureInfo.InvariantCulture;

Console.WriteLine("value | ToEven | AwayFromZero");
foreach (decimal value in new[] { 2.5m, 3.5m, -2.5m, 2.1m })
{
    decimal even = Math.Round(value, 0, MidpointRounding.ToEven);
    decimal away = Math.Round(value, 0, MidpointRounding.AwayFromZero);
    Console.WriteLine($"{value:F1} | {even:F0} | {away:F0}");
}

Resultado

value | ToEven | AwayFromZero
2.5 | 2 | 3
3.5 | 4 | 4
-2.5 | -2 | -3
2.1 | 2 | 2

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes