Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Decimal.ToInt64 Method (Decimal)

 

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

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

Public Shared Function ToInt64 (
	d As Decimal
) As Long

Parameters

d
Type: System.Decimal

The decimal number to convert.

Return Value

Type: System.Int64

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

Exception Condition
OverflowException

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

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

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

The following example uses the ToInt64 method to convert decimal numbers to Int64 values.

Module Example
   Public Sub Main()
      Dim values() As Decimal = { 123d, New Decimal(123000, 0, 0, false, 3), 
                                  123.999d, 18446744073709551615.999d, 
                                  18446744073709551616d, 9223372036854775807.999d, 
                                  9223372036854775808d, -0.999d, -1d, 
                                  -9223372036854775808.999d, 
                                  -9223372036854775809d }

      For Each value In values
         Try
            Dim number As Long = Decimal.ToInt64(value)
            Console.WriteLine("{0} --> {1}", value, number)       
         Catch e As OverflowException
             Console.WriteLine("{0}: {1}", e.GetType().Name, value)
         End Try   
      Next
   End Sub
End Module
' The example displays the following output:
'   123 --> 123
'   123.000 --> 123
'   123.999 --> 123
'   OverflowException: 18446744073709551615.999
'   OverflowException: 18446744073709551616
'   9223372036854775807.999 --> 9223372036854775807
'   OverflowException: 9223372036854775808
'   -0.999 --> 0
'   -1 --> -1
'   -9223372036854775808.999 --> -9223372036854775808
'   OverflowException: -9223372036854775809

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
Return to top
Show: