Zum Hauptinhalt springen

Number.Round

Gibt die gerundete Zahl zurück. Dezimalstellenanzahl und Rundungsmodus können angegeben werden.

Syntax​

Number.Round(
    number as number,
    optional digits as number,
    optional roundingMode as RoundingMode.Type
) as number

Remarks​

Gibt das Ergebnis der Rundung von number auf die nächste Zahl zurück. Wenn number NULL ist, gibt Number.Round NULL zurück.

Standardmäßig wird number auf die nächste ganze Zahl gerundet, und Gleichstände werden durch Rundung auf die nächste gerade Zahl aufgelöst (unter Verwendung von RoundingMode.ToEven, auch bekannt als „unverzerrte Rundung“).

Diese Standardwerte können jedoch über die folgenden optionalen Parameter überschrieben werden.

  • digits: Bewirkt, dass number auf die angegebene Anzahl von Dezimalstellen gerundet wird.
  • roundingMode: Überschreibt das Standardverhalten zur Auflösung von Gleichständen, wenn sich number in der Mitte zwischen zwei möglichen gerundeten Werten befindet. (siehe RoundingMode.Type für mögliche Werte).

Examples​

Example #1​

Rundet 1,234 auf die nächste ganze Zahl.

Number.Round(1.234)

Result:

1

Example #2​

Rundet 1,56 auf die nächste ganze Zahl.

Number.Round(1.56)

Result:

2

Example #3​

Rundet 1,2345 auf zwei Dezimalstellen.

Number.Round(1.2345, 2)

Result:

1.23

Example #4​

Rundet 1,2345 auf drei Dezimalstellen (Aufrundung).

Number.Round(1.2345, 3, RoundingMode.Up)

Result:

1.235

Example #5​

Rundet 1,2345 auf drei Dezimalstellen (Abrundung).

Number.Round(1.2345, 3, RoundingMode.Down)

Result:

1.234

Category​

Number.Rounding