round

Function • Params changed in PHP 8.4

Rounds a float.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
Improved
PHP 8.5
PHP 8.6

round Function synopsis

round(
    int|float $num,
    int $precision = 0,
    RoundingMode|int $mode = RoundingMode::HalfAwayFromZero
  ): float

Parameters

$num

Typeint|float

The value to round.

$precision

OptionalTypeintDefault value0

The optional number of decimal digits to round to.

$mode

OptionalTypeRoundingMode|intDefault valueRoundingMode::HalfAwayFromZero

Use RoundingMode or one of the following constants to specify the mode in which rounding occurs.

   However, please note that some newly added modes only exist in RoundingMode.

$mode accepts one of the following constant values:

Return value

Typefloat

The value rounded to the given $precision as a float.

Changes to the round Function

PHP 8.4

  • Parameter type changed for parameter #3 ($mode): int to RoundingMode|int
  • Parameter default value changed for position #3 ($mode): PHP_ROUND_HALF_UP to RoundingMode::HalfAwayFromZero
  round(
      int|float $num,
      int $precision = 0,
-     int $mode = PHP_ROUND_HALF_UP
+     RoundingMode|int $mode = RoundingMode::HalfAwayFromZero
    ): float

PHP 8.0

  • Return type added: float
  • Parameter name of parameter #1 changed: $number to $num
  • Parameter type added for parameter #1 ($num): int|float
  • Parameter type added for parameter #2 ($precision): int
  • Parameter default value added for position #2 ($precision): 0
  • Parameter type added for parameter #3 ($mode): int
  • Parameter default value added for position #3 ($mode): PHP_ROUND_HALF_UP
  round(
-     $number,
+     int|float $num,
-     $precision,
+     int $precision = 0,
-     $mode
+     int $mode = PHP_ROUND_HALF_UP
-   )
+   ): float

round Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes