Decimal::Round Method (Decimal)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Rounds a decimal value to the nearest integer.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

static Decimal Round(
	Decimal d


Type: System::Decimal

A decimal number to round.

Return Value

Type: System::Decimal

The integer that is nearest to the d parameter. If d is halfway between two integers, one of which is even and the other odd, the even number is returned.

Exception Condition

The result is outside the range of a Decimal value.

The behavior of this method follows IEEE Standard 754, section 4. This kind of rounding is sometimes called round half to even or banker's rounding. It minimizes rounding errors that result from consistently rounding a midpoint value in a single direction. It is equivalent to calling the Round(Decimal, MidpointRounding) method with a mode argument of MidpointRounding::ToEven.

The following example rounds a range of Decimal values between 100 and 102 to the nearest integer. Because the method uses banker's rounding, note that 100.5 rounds to 100 and 101.5 rounds to 102.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top