Math.Truncate Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Calculates the integral part of a number.
| Truncate(Decimal) |
Calculates the integral part of a specified decimal number. |
| Truncate(Double) |
Calculates the integral part of a specified double-precision floating-point number. |
The number is rounded to the nearest integer towards zero.
- Source:
- Math.cs
- Source:
- Math.cs
- Source:
- Math.cs
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 -> decimalPublic Shared Function Truncate (d As Decimal) As DecimalParameters
- d
- 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));
let decimalNumber = 32.7865m
// Displays 32
printfn $"{Math.Truncate decimalNumber}"
let decimalNumber = -32.9012m
// Displays -32
printfn $"{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
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- Math.cs
- Source:
- Math.cs
- Source:
- Math.cs
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 -> doublePublic Shared Function Truncate (d As Double) As DoubleParameters
- d
- 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.
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));
let floatNumber = 32.7865
// Displays 32
printfn $"{Math.Truncate floatNumber}"
// printfn $"{truncate floatNumber}"
let floatNumber = -32.9012
// Displays -32
printfn $"{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
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: