# Delphi/Lazarus: 3 Ways to round a Number to X Decimal Places

Tutorial by Stefan Trost | Last update on 2021-12-14 | Created on 2014-02-19 Most users of Delphi or even Lazarus are thinking about the function Round when it is about rounding a number. Unfortunately, this function cannot be used to keep some of the decimal places of the original value. Using Round, you can only make 1 from the value 1.2345 and you are not able to round this number to one (1.2), two (1.23) or three decimal places (1.235).

But you can do it in another way. I will show you in this tutorial.

## RoundTo

The easiest way is to use the function RoundTo included in Unit Math:

```k := 1.2345;
k := RoundTo(k, -2);  // k = 1.23```

As a first parameter, we are passing our number we would like to round, as a second parameter the number of decimal places, we would like to keep. We have to use negative values at this point in order to round to decimal places. Positive values can be used to round, for example, to hundreds or thousands: RoundTo(12345, 2) = 12300.

## Own Function

It is possible, that older versions of the IDE are not supporting the RoundTo method. In this case, we can just use the following calculation to get to our result:

```x := 1.2345;
k := round(x*100)/100;    // 1.23
k := round(x*1000)/1000;  // 1.235```

Generalized and swapped out as a function results in the following code:

```function RoundEx(const AInput, APlaces): extended;
var
k: extended;
begin
k := power(10, APlaces);
result := round(AInput*k)/k;
end;
```

We have to pass our value as well as the number of decimal places to this function and we can use it just like RoundTo.

In this Rounding Tutorial for Delphi and Lazarus has introduced an extension of this function. With the function presented there, you are able to round in both directions: you can round to an arbitrary number of decimal places as well as to positions before the decimal point.

## Output directly as String

As a third method, I do not want to withhold the possibility to output a floating point number directly and rounded as a string:

```x := 1.2345;
s := FormatFloat('0.00', x);           // 1.23
s := FormatFloat('0.000', x);          // 1.235
s := FormatFloat('0.000000', x);       // 1.234500
s := FormatFloat('0.######', x);       // 1.2345
s := FloatToStrF(x, ffFixed, 11, 2);   // 1.23
s := FloatToStrF(x, ffFixed, 11, 3);   // 1.235```

For this, we can use the functions FormatFloat or FloatToStrF, for example.

To FormatFloat, we are passing the format as a first parameter and the number as the second parameter. When using a 0 in the format string, this digit is outputted in each case, when using a hash #, this digit is outputted only if necessary.

FloatToStrF is providing many possibilities to format a number. In our case, we only have to know, that we have to pass our value as first parameter and the number of our desired decimal places as the last one. Guest

"k := RoundTo(k, 2); // k = 1.23",

should be

"k := RoundTo(k, -2); // k = 1.23".
2016-01-22 at 08:40 Delphian

Thank you very much for this note.

I have corrected the example and wrote something about the difference between negative and positive values.
2016-01-23 at 14:10

Positive Negative Guest

There still seems to be a lack of a general purpose function to set the number of digits after the decimal point.

A 2 digit round off should work with all values not just numbers within a small range.

eg. 1.29343e-6 should round to 1.29e-6

It should do nothing to numbers with positive exponents.
2016-03-11 at 21:26 Guest

I need to round a real number to 2 decimals.
2018-03-07 at 08:28 Delphian

Please tell us what error message you got.

Perhaps, you have forgotten to include the unit "math" to your uses clause.
2018-03-07 at 13:24

Positive Negative Guest

In this example RoundTo(123.375,-2) should round to 123.38 but it rounds to 123.38!!

Whats wrong?
2019-03-06 at 18:32 Guest

In this example RoundTo(124.375,-2) should round to 124.38 but it rounds to 124,37!!!

Whats wrong?
2019-03-06 at 18:34 You can find Software by Stefan Trost on sttmedia.com. Do you need an individual software solution according to your needs? - sttmedia.com/contact
Show Profile