This documentation is archived and is not being maintained.

Decimal.Subtraction Operator

Subtracts two specified Decimal values.

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

public static decimal operator -(
	decimal d1,
	decimal d2


Type: System.Decimal
The minuend.
Type: System.Decimal
The subtrahend.

Return Value

Type: System.Decimal
The result of subtracting d2 from d1.


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

The following code example creates several pairs of Decimal values and calculates their differences with the Subtraction operator.

// Example of the decimal addition and subtraction operators.
using System;

class DecimalAddSubOpsDemo
    const string dataFmt = "   {0,-18}{1,31}" ;

    // Display decimal parameters and their sum and difference.
    static void ShowDecimalSumDiff( decimal Left, decimal Right )
        Console.WriteLine( );
        Console.WriteLine( dataFmt, "decimal Left", Left );
        Console.WriteLine( dataFmt, "decimal Right", Right );
        Console.WriteLine( dataFmt, "Left + Right", 
            Left + Right );
        Console.WriteLine( dataFmt, "Left - Right", 
            Left - Right );

    static void Main( )
        Console.WriteLine( "This example of the decimal " +
            "addition and subtraction operators \ngenerates the " +
            "following output. It displays the sum and \n" +
            "difference of several pairs of decimal objects."  );

        // Create pairs of decimal objects.
            new decimal( 1230000000, 0, 0, false, 7 ), 
            0.0012300M );
        ShowDecimalSumDiff( 123.456789M, 0.006789M );
        ShowDecimalSumDiff( 12345678900000000M, 
            0.00000000123456789M );
        ShowDecimalSumDiff( 123456789.0123456789M, 
            123456789.1123456789M );

This example of the decimal addition and subtraction operators
generates the following output. It displays the sum and
difference of several pairs of decimal objects.

   decimal Left                          123.0000000
   decimal Right                           0.0012300
   Left + Right                          123.0012300
   Left - Right                          122.9987700

   decimal Left                           123.456789
   decimal Right                            0.006789
   Left + Right                           123.463578
   Left - Right                           123.450000

   decimal Left                    12345678900000000
   decimal Right                 0.00000000123456789
   Left + Right       12345678900000000.000000001235
   Left - Right       12345678899999999.999999998765

   decimal Left                 123456789.0123456789
   decimal Right                123456789.1123456789
   Left + Right                 246913578.1246913578
   Left - Right                        -0.1000000000

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.