WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

MidpointRounding – eine Rundungsregel wählen

MidpointRounding legt eine Rundungsregel fest. ToEven und AwayFromZero wählen beide das nächstliegende Ergebnis, behandeln aber Werte unterschiedlich, die genau zwischen zwei möglichen Ergebnissen liegen.

Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

Math.Round(value, digits, MidpointRounding.ToEven)
Math.Round(value, digits, MidpointRounding.AwayFromZero)

MidpointRounding ist eine Enumeration im Namespace System und in .NET 10 verfügbar. Sie können den Rundungsmodus beispielsweise mit Math.Round(value, digits, mode) angeben. Dabei steht digits für die Anzahl der Nachkommastellen. Dies ist eine Bibliotheks-API und kein C#-Syntaxmerkmal, das LangVersion=preview erfordert.

Liegt ein Wert genau in der Mitte zwischen zwei möglichen Rundungsergebnissen, wählt MidpointRounding.ToEven das Ergebnis mit der geraden letzten beibehaltenen Ziffer. Bei digits = 0 wird aus 2.5m der Wert 2 und aus 3.5m der Wert 4. Diese Regel heißt Banker's Rounding (Banker-Rundung). Sie ist der Standard bei Math.Round-Überladungen ohne Parameter für den Rundungsmodus. MidpointRounding.AwayFromZero wählt bei einem Wert genau in der Mitte das Ergebnis, das weiter von null entfernt ist: Aus 2.5m wird 3, aus -2.5m wird -3.

Liegt der Wert nicht genau in der Mitte, wählen beide Modi das nächstliegende Ergebnis: 2.1m wird in beiden Fällen zu 2. AwayFromZero erhöht also nicht immer den Absolutwert. Beim Runden auf eine Nachkommastelle liegt 3.45m genau zwischen zwei möglichen Ergebnissen, 3.451m dagegen nicht. Die anderen Modi – ToZero, ToNegativeInfinity und ToPositiveInfinity – runden alle Werte in die jeweils festgelegte Richtung, nicht nur Werte genau in der Mitte zwischen zwei möglichen Ergebnissen.

Für das Rundungsergebnis ist der tatsächlich gespeicherte Wert maßgeblich. Durch die binäre Darstellung von double kann ein Wert, der in Dezimalschreibweise genau in der Mitte zu liegen scheint, tatsächlich knapp danebenliegen. Das Beispiel verwendet decimal-Literale mit dem Suffix m, um die gezeigten Werte exakt darzustellen, und CultureInfo.InvariantCulture, um das Ausgabeformat festzulegen.

Beispiele

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

Ergebnis

value | ToEven | AwayFromZero
2.5 | 2 | 3
3.5 | 4 | 4
-2.5 | -2 | -3
2.1 | 2 | 2

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen