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
Color Picker