Math.Truncate Math.Truncate Math.Truncate Math.Truncate Method

Definition

Calculates the integral part of a number.

Overloads

Truncate(Decimal) Truncate(Decimal) Truncate(Decimal) Truncate(Decimal)

Calculates the integral part of a specified decimal number.

Truncate(Double) Truncate(Double) Truncate(Double) Truncate(Double)

Calculates the integral part of a specified double-precision floating-point number.

Remarks

The number is rounded to the nearest integer towards zero.

Truncate(Decimal) Truncate(Decimal) Truncate(Decimal) Truncate(Decimal)

Calculates the integral part of a specified decimal number.

public:
 static System::Decimal Truncate(System::Decimal d);
public static decimal Truncate (decimal d);
static member Truncate : decimal -> decimal
Public Shared Function Truncate (d As Decimal) As Decimal

Parameters

d
Decimal Decimal Decimal Decimal

A number to truncate.

Returns

The integral part of d; that is, the number that remains after any fractional digits have been discarded.

Examples

The following example calls the Truncate(Decimal) method to truncate both a positive and a negative Decimal value.

decimal decimalNumber;

decimalNumber = 32.7865m;
// Displays 32
Console.WriteLine(Math.Truncate(decimalNumber));

decimalNumber = -32.9012m;
// Displays -32         
Console.WriteLine(Math.Truncate(decimalNumber));
Dim decimalNumber As Decimal

decimalNumber = 32.7865d
' Displays 32      
Console.WriteLine(Math.Truncate(decimalNumber))

decimalNumber = -32.9012d
' Displays -32
Console.WriteLine(Math.Truncate(decimalNumber))  

Remarks

Truncate rounds d to the nearest integer towards zero.

See also

Truncate(Double) Truncate(Double) Truncate(Double) Truncate(Double)

Calculates the integral part of a specified double-precision floating-point number.

public:
 static double Truncate(double d);
public static double Truncate (double d);
static member Truncate : double -> double
Public Shared Function Truncate (d As Double) As Double

Parameters

d
Double Double Double Double

A number to truncate.

Returns

The integral part of d; that is, the number that remains after any fractional digits have been discarded, or one of the values listed in the following table.

d Return value
NaNNaN
NegativeInfinityNegativeInfinity
PositiveInfinityPositiveInfinity

Examples

The following example calls the Truncate(Double) method to truncate both a positive and a negative Double value.

double floatNumber;

floatNumber = 32.7865;
// Displays 32      
Console.WriteLine(Math.Truncate(floatNumber));

floatNumber = -32.9012;
// Displays -32       
Console.WriteLine(Math.Truncate(floatNumber));
Dim floatNumber As Double

floatNumber = 32.7865
' Displays 32      
Console.WriteLine(Math.Truncate(floatNumber)) 

floatNumber = -32.9012
' Displays -32
Console.WriteLine(Math.Truncate(floatNumber))

Remarks

Truncate rounds d to the nearest integer towards zero.

Starting with Visual Basic 15.8, the performance of Double-to-integer conversion is optimized if you pass the value returned by the Truncate method to the any of the integral conversion functions, or if the Double value returned by Truncate is automatically converted to an integer with Option Strict set to Off. This optimization allows code to run faster -- up to twice as fast for code that does a large number of conversions to integer types. The following example illustrates such an optimized conversion:

Dim d As Double = 164.7194
Dim i As Integer = CInt(Math.Truncate(d))     ' Result: 164
See also

Applies to