Decimal.Subtraction(Decimal, Decimal) Operator

Definition

Subtracts two specified Decimal values.

public:
 static System::Decimal operator -(System::Decimal d1, System::Decimal d2);
public:
 static System::Decimal operator -(System::Decimal d1, System::Decimal d2) = System::Numerics::ISubtractionOperators<System::Decimal, System::Decimal, System::Decimal>::op_Subtraction;
public static decimal operator - (decimal d1, decimal d2);
static member ( - ) : decimal * decimal -> decimal
Public Shared Operator - (d1 As Decimal, d2 As Decimal) As Decimal

Parameters

d1
Decimal

The minuend.

d2
Decimal

The subtrahend.

Returns

The result of subtracting d2 from d1.

Implements

Exceptions

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

Remarks

The Subtraction method defines the operation of the subtraction operator for Decimal values. It enables code such as the following:

using System;

public class Example
{
   public static void Main()
   {
      Decimal number1 = 120.07m;
      Decimal number2 = 163.19m;
      Decimal number3 = number1 - number2;
      Console.WriteLine("{0} - {1} = {2}",
                        number1, number2, number3);
   }
}
// The example displays the following output:
//        120.07 - 163.19 = -43.12
let number1 = 120.07m
let number2 = 163.19m
let number3 = number1 - number2
printfn $"{number1} - {number2} = {number3}"

// The example displays the following output:
//        120.07 - 163.19 = -43.12
Module Example
   Public Sub Main()
      Dim number1 As Decimal = 120.07d 
      Dim number2 As Decimal = 163.19d 
      Dim number3 As Decimal = number1 - number2
      Console.WriteLine("{0} - {1} = {2}", 
                        number1, number2, number3)
   End Sub
End Module
' The example displays the following output:
'       120.07 - 163.19 = -43.12

If the language you're using doesn't support custom operators, call the Subtract method instead.

The equivalent method for this operator is Decimal.Subtract(Decimal, Decimal)

Applies to

See also