Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

MidpointRounding.AwayFromZero com decimal.Round

Arredonda para o valor mais próximo e, apenas em caso de empate exato, escolhe o valor com maior valor absoluto.

Versão: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxe

public static decimal Round(decimal d, int decimals, System.MidpointRounding mode);
public static decimal Round(decimal d, System.MidpointRounding mode);

// Call with an explicit midpoint rule:
decimal rounded = decimal.Round(2.25m, 1, System.MidpointRounding.AwayFromZero);

Em C# 12 e .NET 8, decimal.Round(d, decimals, MidpointRounding.AwayFromZero) devolve um decimal, o alias de C# para System.Decimal. AwayFromZero é um membro da enumeração System.MidpointRounding e é passado ao método estático como argumento mode. O sufixo m indica um literal do tipo decimal, não double.

O método escolhe o valor mais próximo com o número de casas decimais pedido. Só em caso de empate exato é que AwayFromZero escolhe o valor de maior módulo: a uma casa decimal, 2.25m dá 2.3m e -2.25m dá -2.3m. Sem empate, 2.24m dá 2.2m. A regra predefinida ToEven de decimal.Round(d, decimals) resolve o empate escolhendo o resultado cujo último algarismo mantido é par. Já o modo dirigido ToZero arredonda em direção a zero mesmo quando não há empate.

decimals indica o número de casas após o separador decimal, de 0 a 28, inclusive. decimal.Round(d, mode) arredonda para um número inteiro, mas continua a devolver um decimal. Na sobrecarga com três argumentos, decimals fora do intervalo provoca ArgumentOutOfRangeException e mode com um valor não definido provoca ArgumentException.

Exemplos

using System;
using System.Globalization;

decimal[] values = [2.25m, -2.25m, 2.24m, 2.26m];

Console.WriteLine("Input | Default | AwayFromZero");
foreach (decimal value in values)
{
    decimal defaultResult = decimal.Round(value, 1);
    decimal explicitResult = decimal.Round(value, 1, MidpointRounding.AwayFromZero);
    Console.WriteLine(string.Create(CultureInfo.InvariantCulture,
        $"{value:F2} | {defaultResult:F1} | {explicitResult:F1}"));
}

Resultado

Input | Default | AwayFromZero
2.25 | 2.2 | 2.3
-2.25 | -2.2 | -2.3
2.24 | 2.2 | 2.2
2.26 | 2.3 | 2.3

Compara as colunas: os modos só diferem nas duas linhas com empate exato. `CultureInfo.InvariantCulture` mantém o ponto decimal na saída.

Lições relacionadas

  • C# · Lição 7 · Avançado · Versão: 3

Fontes