CKTIS / C#
MidpointRounding — escolher uma regra de arredondamento
MidpointRounding especifica uma regra de arredondamento. ToEven e AwayFromZero escolhem ambos o resultado mais próximo, mas tratam de forma diferente os valores exatamente a meio caminho entre dois resultados possíveis.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
Math.Round(value, digits, MidpointRounding.ToEven)
Math.Round(value, digits, MidpointRounding.AwayFromZero)MidpointRounding é uma enumeração do espaço de nomes System, disponível no .NET 10. Passe-a, por exemplo, a uma sobrecarga como Math.Round(value, digits, mode), em que digits indica o número de casas decimais. Trata-se de uma API de biblioteca, não de uma funcionalidade da sintaxe C# que exija LangVersion=preview.
MidpointRounding.ToEven resolve um empate escolhendo o resultado cuja última casa mantida é par: com digits = 0, 2.5m dá 2 e 3.5m dá 4. Este método chama-se arredondamento bancário e é o comportamento predefinido das sobrecargas de Math.Round sem um parâmetro de modo de arredondamento. MidpointRounding.AwayFromZero resolve um empate escolhendo o resultado mais afastado de zero: 2.5m dá 3 e -2.5m dá -3.
Fora dos empates, ambos os modos escolhem o resultado mais próximo: 2.1m dá 2 em qualquer dos casos. Assim, AwayFromZero não aumenta sempre o valor absoluto. Com uma casa decimal, 3.45m está a meio caminho, mas 3.451m não está. Os outros modos — ToZero, ToNegativeInfinity e ToPositiveInfinity — arredondam todos os valores numa direção especificada, não apenas os que estão a meio caminho.
O resultado depende do valor efetivamente armazenado. A representação binária de double pode fazer com que um valor aparentemente a meio caminho em decimal não seja um empate. O exemplo usa literais decimal com o sufixo m para representar exatamente os valores apresentados e CultureInfo.InvariantCulture para fixar o formato da saída.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.