Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

MidpointRounding.AwayFromZero con decimal.Round

Arrotonda al valore più vicino e scegli quello con valore assoluto maggiore solo quando i due valori sono equidistanti.

Versione: C# 12 and .NET 8; later runtimes may add compatible features

Sintassi

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

In C# 12 e .NET 8, decimal.Round(d, decimals, MidpointRounding.AwayFromZero) restituisce un decimal, l’alias C# di System.Decimal. AwayFromZero è un membro dell’enumerazione System.MidpointRounding e si passa al metodo statico come argomento mode. Il suffisso m indica un letterale di tipo decimal, non double.

Il metodo sceglie il valore più vicino alla precisione decimale richiesta. Solo se i due valori sono esattamente equidistanti, AwayFromZero sceglie quello con valore assoluto maggiore: a una cifra decimale, 2.25m diventa 2.3m e -2.25m diventa -2.3m. Se non c’è parità, 2.24m diventa 2.2m. La regola predefinita ToEven di decimal.Round(d, decimals) risolve la parità scegliendo il risultato con l’ultima cifra conservata pari. La modalità direzionale ToZero, invece, arrotonda verso zero anche in assenza di parità.

decimals indica il numero di cifre dopo il separatore decimale, da 0 a 28 inclusi. decimal.Round(d, mode) arrotonda a un intero, ma restituisce comunque un decimal. Nell’overload a tre argomenti, un decimals fuori intervallo genera ArgumentOutOfRangeException e un mode non definito genera ArgumentException.

Esempi

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

Risultato

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

Confronta le colonne: le modalità differiscono solo nelle due righe con valori esattamente a metà. `CultureInfo.InvariantCulture` mantiene il punto decimale nell’output.

Lezioni correlate

  • C# · Lezione 7 · Avanzato · Versione: 3

Fonti