# Decimal.Decrement Operator (Decimal)

.NET Framework (current version)

Note

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

Decrements the Decimal operand by one.

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

## Syntax

```public static decimal operator --(
decimal d
)
```

#### Parameters

d
Type: System.Decimal

The value to decrement.

#### Return Value

Type: System.Decimal

The value of d decremented by 1.

## Exceptions

Exception Condition
OverflowException

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

## Remarks

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

```using System;

public class Example
{
public static void Main()
{
Decimal number = 1079.8m;
Console.WriteLine("Original value:    {0:N}", number);
Console.WriteLine("Decremented value: {0:N}", --number);
}
}
// The example displays the following output:
//       Original value:    1,079.80
//       Decremented value: 1,078.80
```

Some languages (such as Visual Basic) that lack an increment operator can call the Decrement method directly, as the following example shows.

```Module Example
Public Sub Main()
Dim number As Decimal = 1079.8d
Console.WriteLine("Original value:    {0:N}", number)
Console.WriteLine("Decremented value: {0:N}", Decimal.op_Decrement(number))
End Sub
End Module
' The example displays the following output:
'       Original value:    1,079.80
'       Decremented value: 1,078.80
```

If your language does not support custom operators, call the Subtract method instead, as the following example shows.

```using System;

public class Example
{
public static void Main()
{
Decimal number = 1079.8m;
Console.WriteLine("Original value:    {0:N}", number);
Console.WriteLine("Decremented value: {0:N}", Decimal.Subtract(number, 1));
}
}
// The example displays the following output:
//       Original value:    1,079.80
//       Decremented value: 1,078.80
```

## Version Information

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1