Decimal.ToInt32(Decimal) Method

Definition

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Source:

Decimal.cs

Converts the value of the specified Decimal to the equivalent 32-bit signed integer.

C#

public static int ToInt32(decimal d);

Parameters

d

Decimal

The decimal number to convert.

Returns

Int32

A 32-bit signed integer equivalent to the value of d.

Exceptions

OverflowException

d is less than Int32.MinValue or greater than Int32.MaxValue.

Examples

The following example uses the ToInt32 method to convert decimal numbers to Int32 values.

C#

using System;

class Example
{
   public static void Main( )
   {
      decimal[] values = { 123m, new decimal(123000, 0, 0, false, 3),
                           123.999m, 4294967295.999m, 4294967296m,
                           4294967296m, 2147483647.999m, 2147483648m,
                           -0.999m, -1m, -2147483648.999m, -2147483649m };

      foreach (var value in values) {
         try {
            int number = Decimal.ToInt32(value);
            Console.WriteLine("{0} --> {1}", value, number);
         }
         catch (OverflowException e)
         {
             Console.WriteLine("{0}: {1}", e.GetType().Name, value);
         }
      }
   }
}
// The example displays the following output:
//      123 --> 123
//      123.000 --> 123
//      123.999 --> 123
//      OverflowException: 4294967295.999
//      OverflowException: 4294967296
//      OverflowException: 4294967296
//      2147483647.999 --> 2147483647
//      OverflowException: 2147483648
//      -0.999 --> 0
//      -1 --> -1
//      -2147483648.999 --> -2147483648
//      OverflowException: -2147483649

Remarks

The return value is the integral part of the decimal value; fractional digits are truncated.

You can also convert a Decimal value to a 32-bit integer by using the Explicit assignment operator. Because the operator performs a narrowing conversion, you must use a casting operator in C# or a conversion function in Visual Basic.

Applies to

See also

• Int32