CakeFest 2025 Madrid: The Official CakePHP Conference

round

(PHP 4, PHP 5, PHP 7, PHP 8)

round — Rundet einen Gleitkommawert

Beschreibung

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

Rundet den Parameter num auf die mit precision angegebene Anzahl von Nachkommastellen. precision kann dabei auch Null (Vorgabewert) oder negativ sein. So wird bei einer Stellenzahl von -1 z. B. auf volle Zehner gerundet.

Parameter-Liste

num

Der zu rundende Wert.

precision

Auf wie viele Nachkommastellen gerundet werden soll.

Ist die Genauigkeit precision positiv, wird num auf precision signifikante Stellen nach dem Dezimalpunkt gerundet.

Ist die Genauigkeit precision negativ, wird num auf precision signifikante Stellen vor dem Dezimalpunkt gerundet, d. h. auf das nächste Vielfache von pow(10, -precision), z. B. wird num mit einer precision von -1 auf Zehner gerundet, mit einer precision von -2 auf Hunderter usw.

mode

Um den Rundungsmodus festzulegen, kann RoundingMode oder eine der folgenden Konstanten verwendet werden.

Konstanten	Beschreibung
`PHP_ROUND_HALF_UP`	Rundet `num` auf halber Strecke von Null weg, womit 1.5 zu 2 wird und -1.5 zu -2.
`PHP_ROUND_HALF_DOWN`	Rundet `num` auf halber Strecke zu Null hin, womit 1.5 zu 1 wird und -1.5 zu -1.
`PHP_ROUND_HALF_EVEN`	Rundet `num` auf halber Strecke auf den nächsten geraden Wert, womit sowohl 1.5 als auch 2.5 zu 2 werden.
`PHP_ROUND_HALF_ODD`	Rundet `num` auf halber Strecke auf den nächsten ungeraden Wert, womit 1.5 zu 1 wird und 2.5 zu 3.

Es ist jedoch zu beachten, dass einige neu hinzugefügte Modi nur in RoundingMode existieren.

Rückgabewerte

Der auf die angegebene precision gerundete Wert als Float.

Fehler/Exceptions

Wenn mode ungültig ist, löst die Funktion einen ValueError aus. Vor PHP 8.4.0 wurde bei einem ungültigen Modus automatisch PHP_ROUND_HALF_UP verwendet.

Changelog

Version	Beschreibung
8.4.0	Vier neue Rundungsmodi wurden hinzugefügt.
8.4.0	Es wird nun ein ValueError ausgelöst, wenn `mode` ungültig ist.
8.0.0	`num` akzeptiert keine internen Objekte mehr, die eine numerische Konvertierung unterstützen.

Beispiele

Beispiel #1 round()-Beispiele

<?php
var_dump(round(3.4));
var_dump(round(3.5));
var_dump(round(3.6));
var_dump(round(3.6, 0));
var_dump(round(5.045, 2));
var_dump(round(5.055, 2));
var_dump(round(345, -2));
var_dump(round(345, -3));
var_dump(round(678, -2));
var_dump(round(678, -3));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

float(3)
float(4)
float(4)
float(4)
float(5.05)
float(5.06)
float(300)
float(0)
float(700)
float(1000)

Beispiel #2 Wie precision eine Gleitkommazahl betrifft

<?php
$number = 135.79;

var_dump(round($number, 3));
var_dump(round($number, 2));
var_dump(round($number, 1));
var_dump(round($number, 0));
var_dump(round($number, -1));
var_dump(round($number, -2));
var_dump(round($number, -3));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

float(135.79)
float(135.79)
float(135.8)
float(136)
float(140)
float(100)
float(0)

Beispiel #3 mode-Beispiele

<?php
echo 'Rundundsmodi mit 9.5' . PHP_EOL;
var_dump(round(9.5, 0, PHP_ROUND_HALF_UP));
var_dump(round(9.5, 0, PHP_ROUND_HALF_DOWN));
var_dump(round(9.5, 0, PHP_ROUND_HALF_EVEN));
var_dump(round(9.5, 0, PHP_ROUND_HALF_ODD));

echo PHP_EOL;
echo 'Rundundsmodi mit 8.5' . PHP_EOL;
var_dump(round(8.5, 0, PHP_ROUND_HALF_UP));
var_dump(round(8.5, 0, PHP_ROUND_HALF_DOWN));
var_dump(round(8.5, 0, PHP_ROUND_HALF_EVEN));
var_dump(round(8.5, 0, PHP_ROUND_HALF_ODD));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Rundundsmodi mit 9.5
float(10)
float(9)
float(10)
float(9)

Rundundsmodi mit 8.5
float(9)
float(8)
float(8)
float(9)

Beispiel #4 Beispiele für mode mit precision

<?php
echo 'Verwendung von PHP_ROUND_HALF_UP mit einer Dezimalstelle Genauigkeit' . PHP_EOL;
var_dump(round( 1.55, 1, PHP_ROUND_HALF_UP));
var_dump(round(-1.55, 1, PHP_ROUND_HALF_UP));

echo PHP_EOL;
echo 'Verwendung von PHP_ROUND_HALF_DOWN mit einer Dezimalstelle Genauigkeit' . PHP_EOL;
var_dump(round( 1.55, 1, PHP_ROUND_HALF_DOWN));
var_dump(round(-1.55, 1, PHP_ROUND_HALF_DOWN));

echo PHP_EOL;
echo 'Verwendung von PHP_ROUND_HALF_EVEN mit einer Dezimalstelle Genauigkeit' . PHP_EOL;
var_dump(round( 1.55, 1, PHP_ROUND_HALF_EVEN));
var_dump(round(-1.55, 1, PHP_ROUND_HALF_EVEN));

echo PHP_EOL;
echo 'Verwendung von PHP_ROUND_HALF_ODD mit einer Dezimalstelle Genauigkeit' . PHP_EOL;
var_dump(round( 1.55, 1, PHP_ROUND_HALF_ODD));
var_dump(round(-1.55, 1, PHP_ROUND_HALF_ODD));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Verwendung von PHP_ROUND_HALF_UP mit einer Dezimalstelle Genauigkeit
float(1.6)
float(-1.6)

Verwendung von PHP_ROUND_HALF_DOWN mit einer Dezimalstelle Genauigkeit
float(1.5)
float(-1.5)

Verwendung von PHP_ROUND_HALF_EVEN mit einer Dezimalstelle Genauigkeit
float(1.6)
float(-1.6)

Verwendung von PHP_ROUND_HALF_ODD mit einer Dezimalstelle Genauigkeit
float(1.5)
float(-1.5)

Beispiel #5 Beispiel für die Verwendung von RoundingMode

<?php
foreach (RoundingMode::cases() as $mode) {
    foreach ([
        8.5,
        9.5,
        -3.5,
    ] as $number) {
        printf("%-17s: %+.17g -> %+.17g\n", $mode->name, $number, round($number, 0, $mode));
    }
    echo "\n";
}
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

HalfAwayFromZero : +8.5 -> +9
HalfAwayFromZero : +9.5 -> +10
HalfAwayFromZero : -3.5 -> -4

HalfTowardsZero  : +8.5 -> +8
HalfTowardsZero  : +9.5 -> +9
HalfTowardsZero  : -3.5 -> -3

HalfEven         : +8.5 -> +8
HalfEven         : +9.5 -> +10
HalfEven         : -3.5 -> -4

HalfOdd          : +8.5 -> +9
HalfOdd          : +9.5 -> +9
HalfOdd          : -3.5 -> -3

TowardsZero      : +8.5 -> +8
TowardsZero      : +9.5 -> +9
TowardsZero      : -3.5 -> -3

AwayFromZero     : +8.5 -> +9
AwayFromZero     : +9.5 -> +10
AwayFromZero     : -3.5 -> -4

NegativeInfinity : +8.5 -> +8
NegativeInfinity : +9.5 -> +9
NegativeInfinity : -3.5 -> -4

PositiveInfinity : +8.5 -> +9
PositiveInfinity : +9.5 -> +10
PositiveInfinity : -3.5 -> -3

Siehe auch

ceil() - Rundet Brüche auf
floor() - Rundet Brüche ab
number_format() - Formatiert eine Zahl mit Tausender-Trennzeichen

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

User Contributed Notes 13 notes

up

down

324

takingsides at gmail dot com ¶

11 years ago

In my opinion this function lacks two flags:

- PHP_ROUND_UP - Always round up.
- PHP_ROUND_DOWN - Always round down.

In accounting, it's often necessary to always round up, or down to a precision of thousandths.

<?php
function round_up($number, $precision = 2)
{
    $fig = (int) str_pad('1', $precision, '0');
    return (ceil($number * $fig) / $fig);
}

function round_down($number, $precision = 2)
{
    $fig = (int) str_pad('1', $precision, '0');
    return (floor($number * $fig) / $fig);
}
?>

up

down

33

depaula at unilogica dot com ¶

8 years ago

As PHP doesn't have a a native number truncate function, this is my solution - a function that can be usefull if you need truncate instead round a number.

<?php
/**
 * Truncate a float number, example: <code>truncate(-1.49999, 2); // returns -1.49
 * truncate(.49999, 3); // returns 0.499
 * </code>
 * @param float $val Float number to be truncate
 * @param int f Number of precision
 * @return float
 */
function truncate($val, $f="0")
{
    if(($p = strpos($val, '.')) !== false) {
        $val = floatval(substr($val, 0, $p + 1 + $f));
    }
    return $val;
}
?>

Originally posted in http://stackoverflow.com/a/12710283/1596489

up

down

30

slimusgm at gmail dot com ¶

10 years ago

If you have negative zero and you need return positive number simple add +0:

$number = -2.38419e-07;
var_dump(round($number,1));//float(-0)
var_dump(round($number,1) + 0);//float(0)

up

down

21

djcox99 at googlemail dot com ¶

11 years ago

I discovered that under some conditions you can get rounding errors with round when converting the number to a string afterwards.

To fix this I swapped round() for number_format().

Unfortunately i cant give an example (because the number cant be represented as a string !)

essentially I had round(0.688888889,2);

which would stay as 0.68888889 when printed as a string.

But using number_format it correctly became 0.69.

up

down

18

esion99 at gmail dot com ¶

10 years ago

Unexpected result or misunderstanding (php v5.5.9)

<?php

echo round(1.55, 1, PHP_ROUND_HALF_DOWN); // 1.5
echo round(1.551, 1, PHP_ROUND_HALF_DOWN); //1.6

?>

up

down

10

craft at ckdevelop dot org ¶

11 years ago

function mround($val, $f=2, $d=6){
    return sprintf("%".$d.".".$f."f", $val);
}

echo mround(34.89999);  //34.90

up

down

19

twan at ecreation dot nl ¶

25 years ago

If you'd only want to round for displaying variables (not for calculating on the rounded result) then you should use printf with the float:



<?php printf ("%6.2f",3.39532); ?>



This returns: 3.40 .

up

down

17

Anonymous ¶

14 years ago

Here is function that rounds to a specified increment, but always up. I had to use it for price adjustment that always went up to $5 increments.



<?php  

function roundUpTo($number, $increments) {

    $increments = 1 / $increments;

    return (ceil($number * $increments) / $increments);

}

?>

up

down

8

christian at deligant dot net ¶

13 years ago

this function (as all mathematical operators) takes care of the setlocale setting, resulting in some weirdness when using the result where the english math notation is expected, as the printout of the result in a width: style attribute!



<?php

$a=3/4;

echo round($a, 2); // 0.75



setlocale(LC_ALL, 'it_IT@euro', 'it_IT', 'it');

$b=3/4;

echo round($b,2); // 0,75

?>

up

down

7

michaeldnelson dot mdn at gmail dot com ¶

15 years ago

This function will let you round to an arbitrary non-zero number.  Zero of course causes a division by zero.



<?php

function roundTo($number, $to){

    return round($number/$to, 0)* $to;

}



echo roundTo(87.23, 20); //80

echo roundTo(-87.23, 20); //-80

echo roundTo(87.23, .25); //87.25

echo roundTo(.23, .25); //.25

?>

up

down

3

greghenle at gmail dot com ¶

8 years ago

/**
 * Round to first significant digit
 * +N to +infinity
 * -N to -infinity
 *
 */
function round1stSignificant ( $N ) {
  if ( $N === 0 ) {
    return 0;
  }

  $x = floor ( log10 ( abs( $N ) ) );

  return ( $N > 0 )
    ? ceil( $N * pow ( 10, $x * -1 ) ) * pow( 10, $x )
    : floor( $N * pow ( 10, $x * -1 ) ) * pow( 10, $x );
}

echo round1stSignificant( 39144818 ) . PHP_EOL;
echo round1stSignificant( 124818 ) . PHP_EOL;
echo round1stSignificant( 0.07468 ) . PHP_EOL;
echo round1stSignificant( 0 ) . PHP_EOL;
echo round1stSignificant( -0.07468 ) . PHP_EOL;

/**
 * Output
 * 
 * 40000000
 * 200000
 * 0.08
 * 0
 * -0.08
 * 
 */

up

down

9

php at silisoftware dot com ¶

22 years ago

Here's a function to round to an arbitary number of significant digits. Don't confuse it with rounding to a negative precision - that counts back from the decimal point, this function counts forward from the Most Significant Digit.



ex:



<?php

round(1241757, -3); // 1242000

RoundSigDigs(1241757, 3); // 1240000

?>



Works on negative numbers too. $sigdigs should be >= 0



<?php

function RoundSigDigs($number, $sigdigs) {

    $multiplier = 1;

    while ($number < 0.1) {

        $number *= 10;

        $multiplier /= 10;

    }

    while ($number >= 1) {

        $number /= 10;

        $multiplier *= 10;

    }

    return round($number, $sigdigs) * $multiplier;

}

?>

up

down

3

dastra ¶

12 years ago

round() will sometimes return E notation when rounding a float when the amount is small enough - see  https://bugs.php.net/bug.php?id=44223 .  Apparently it's a feature.

To work around this "feature" when converting to a string, surround your round statement with an sprintf:

sprintf("%.10f", round( $amountToBeRounded, 10));