CKTIS / C#
MidpointRounding.AwayFromZero mit decimal.Round
Runde auf den nächstgelegenen Wert und wähle nur bei exakt gleichem Abstand den Wert mit dem größeren Betrag.
Version: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
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 und .NET 8 gibt decimal.Round(d, decimals, MidpointRounding.AwayFromZero) einen decimal zurück, den C#-Alias für System.Decimal. AwayFromZero ist ein Member des Enumerationstyps System.MidpointRounding und wird der statischen Methode als Argument mode übergeben. Das Suffix m kennzeichnet ein Literal vom Typ decimal, nicht double.
Die Methode wählt den nächstgelegenen Wert mit der gewünschten Anzahl an Nachkommastellen. Nur bei exakt gleichem Abstand wählt AwayFromZero den Wert mit dem größeren Betrag: Bei einer Nachkommastelle wird aus 2.25m der Wert 2.3m und aus -2.25m der Wert -2.3m. Ohne Gleichstand wird aus 2.24m der Wert 2.2m. Die Standardregel ToEven in decimal.Round(d, decimals) wählt bei Gleichstand das Ergebnis mit gerader letzter beibehaltener Ziffer. Der gerichtete Modus ToZero rundet dagegen auch ohne Gleichstand in Richtung null.
decimals gibt die Zahl der Nachkommastellen an und liegt zwischen 0 und 28 einschließlich. decimal.Round(d, mode) rundet auf eine ganze Zahl, gibt aber weiterhin decimal zurück. Bei der Überladung mit drei Argumenten führt ein ungültiger Wert für decimals zu ArgumentOutOfRangeException, ein nicht definierter Wert für mode zu ArgumentException.
Beispiele
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}"));
}Ergebnis
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
Vergleiche die Spalten: Die Modi unterscheiden sich nur in den beiden Zeilen mit exakt gleichem Abstand. `CultureInfo.InvariantCulture` sorgt für den Dezimalpunkt in der Ausgabe.
Zugehörige Lektionen
- C# · Lektion 7 · Fortgeschritten · Version: 3