Decimal.Modulus(Decimal, Decimal) Operator

Definition

Returns the remainder resulting from dividing two specified Decimal values.

C#
public static decimal operator % (decimal d1, decimal d2);

Parameters

d1
Decimal

The dividend.

d2
Decimal

The divisor.

Returns

The remainder resulting from dividing d1 by d2.

Implements

Exceptions

d2 is zero.

The return value is less than Decimal.MinValue or greater than Decimal.MaxValue.

Remarks

The Modulus operator defines the remainder operation that returns the remainder resulting from dividing two specified Decimal values. It enables code such as the following:

C#
using System;

public class Example
{
   public static void Main()
   {
      Decimal number1 = 16.8m;
      Decimal number2 = 4.1m;
      Decimal number3 = number1 % number2;
      Console.WriteLine("{0:N2} % {1:N2} = {2:N2}",
                        number1, number2, number3);
   }
}
// The example displays the following output:
//        16.80 % 4.10 = 0.40

The sign of the value returned by the remainder operation depends on the sign of dividend. If dividend is positive, the remainder operation returns a positive result; if it is negative, the remainder operation returns a negative result.

The equivalent method for this operator is Decimal.Remainder(Decimal, Decimal). If the language you're using doesn't support custom operators, call the Remainder method instead.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

See also