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.