THE WORLD'S LARGEST WEB DEVELOPER SITE

PHP round() Function

❮ PHP Math Reference

Example

Round numbers:

<?php
echo(round(0.60) . "<br>");
echo(round(0.50) . "<br>");
echo(round(0.49) . "<br>");
echo(round(-4.40) . "<br>");
echo(round(-4.60));
?>
Run example »

Definition and Usage

The round() function rounds a floating-point number.

Tip: To round a number UP to the nearest integer, look at the ceil() function.

Tip: To round a number DOWN to the nearest integer, look at the floor() function.


Syntax

round(number,precision,mode);

Parameter Description
number Required. Specifies the value to round
precision Optional. Specifies the number of decimal digits to round to. Default is 0
mode Optional. Specifies a constant to specify the rounding mode:
  • PHP_ROUND_HALF_UP - Default. Rounds number up to precision decimal, when it is half way there. Rounds 1.5 to 2 and -1.5 to -2
  • PHP_ROUND_HALF_DOWN - Round number down to precision decimal places, when it is half way there. Rounds 1.5 to 1 and -1.5 to -1
  • PHP_ROUND_HALF_EVEN - Round number to precision decimal places towards the next even value
  • PHP_ROUND_HALF_ODD - Round number to precision decimal places towards the next odd value


Technical Details

Return Value: The rounded value
Return Type: Float
PHP Version: 4+
PHP Changelog: PHP 5.3: The mode parameter was added

More Examples

Example 1

Round numbers to two decimals:

<?php
echo(round(4.96754,2) . "<br>");
echo(round(7.045,2) . "<br>");
echo(round(7.055,2));
?>
Run example »

Example 2

Round numbers using the constants:

<?php
echo(round(1.5,0,PHP_ROUND_HALF_UP) . "<br>");
echo(round(-1.5,0,PHP_ROUND_HALF_UP) . "<br>");

echo(round(1.5,0,PHP_ROUND_HALF_DOWN) . "<br>");
echo(round(-1.5,0,PHP_ROUND_HALF_DOWN) . "<br>");

echo(round(1.5,0,PHP_ROUND_HALF_EVEN) . "<br>");
echo(round(-1.5,0,PHP_ROUND_HALF_EVEN) . "<br>");

echo(round(1.5,0,PHP_ROUND_HALF_ODD) . "<br>");
echo(round(-1.5,0,PHP_ROUND_HALF_ODD));
?>
Run example »

❮ PHP Math Reference