round

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

roundRundet einen Gleitkommawert

Beschreibung

round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): 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

Eine der folgenden Konstanten kann verwendet werden, um den Rundungsmodus festzulegen.

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.

Rückgabewerte

Der auf die angegebene precision gerundete Wert als Float.

Changelog

Version Beschreibung
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.60));
var_dump(round(5.0452));
var_dump(round(5.0552));
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($number3));
var_dump(round($number2));
var_dump(round($number1));
var_dump(round($number0));
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.50PHP_ROUND_HALF_UP));
var_dump(round(9.50PHP_ROUND_HALF_DOWN));
var_dump(round(9.50PHP_ROUND_HALF_EVEN));
var_dump(round(9.50PHP_ROUND_HALF_ODD));

echo 
PHP_EOL;
echo 
'Rundundsmodi mit 8.5' PHP_EOL;
var_dump(round(8.50PHP_ROUND_HALF_UP));
var_dump(round(8.50PHP_ROUND_HALF_DOWN));
var_dump(round(8.50PHP_ROUND_HALF_EVEN));
var_dump(round(8.50PHP_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(round1.551PHP_ROUND_HALF_UP));
var_dump(round(-1.551PHP_ROUND_HALF_UP));

echo 
PHP_EOL;
echo 
'Verwendung von PHP_ROUND_HALF_DOWN mit einer Dezimalstelle Genauigkeit' PHP_EOL;
var_dump(round1.551PHP_ROUND_HALF_DOWN));
var_dump(round(-1.551PHP_ROUND_HALF_DOWN));

echo 
PHP_EOL;
echo 
'Verwendung von PHP_ROUND_HALF_EVEN mit einer Dezimalstelle Genauigkeit' PHP_EOL;
var_dump(round1.551PHP_ROUND_HALF_EVEN));
var_dump(round(-1.551PHP_ROUND_HALF_EVEN));

echo 
PHP_EOL;
echo 
'Verwendung von PHP_ROUND_HALF_ODD mit einer Dezimalstelle Genauigkeit' PHP_EOL;
var_dump(round1.551PHP_ROUND_HALF_ODD));
var_dump(round(-1.551PHP_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)

Siehe auch

Hier Kannst Du einen Kommentar verfassen


Bitte gib mindestens 10 Zeichen ein.
Wird geladen... Bitte warte.
* Pflichtangabe
Es sind noch keine Kommentare vorhanden.

Was genau bedeutet "Vibe Coding"? Ein tiefgehender Blick für Entwickler

In der Welt der Softwareentwicklung gibt es unzählige Wege, wie man an ein Projekt herangeht. Manche schwören auf strikte Planung, andere auf bewährte Algorithmen und wieder andere lassen sich von etwas ganz anderem leiten: ihrem Gefühl. ...

admin

Autor : admin
Kategorie: Software & Web-Development

PHP cURL-Tutorial: Verwendung von cURL zum Durchführen von HTTP-Anfragen

cURL ist eine leistungsstarke PHP-Erweiterung, die es Ihnen ermöglicht, mit verschiedenen Servern über verschiedene Protokolle wie HTTP, HTTPS, FTP und mehr zu kommunizieren. ...

TheMax

Autor : TheMax
Kategorie: PHP-Tutorials

Midjourney Tutorial - Anleitung für Anfänger

Über Midjourney, dem Tool zur Erstellung digitaler Bilder mithilfe von künstlicher Intelligenz, gibt es ein informatives Video mit dem Titel "Midjourney Tutorial auf Deutsch - Anleitung für Anfänger" ...

Mike94

Autor : Mike94
Kategorie: KI Tutorials

Tutorial veröffentlichen

Tutorial veröffentlichen

Teile Dein Wissen mit anderen Entwicklern weltweit

Du bist Profi in deinem Bereich und möchtest dein Wissen teilen, dann melde dich jetzt an und teile es mit unserer PHP-Community

mehr erfahren

Tutorial veröffentlichen

Feedback zu meinem ersten responsiven Webprojekt

Hallo zusammen, ich bin noch ganz am Anfang meiner Reise als Webdesigner und habe vor kurzem mein erstes kleines responsives Projekt fertiggestel ...

Geschrieben von Mollyyy am 08.08.2025 22:38:01
Forum: Webmaster
Probleme mit einfacher Login-Funktion

Zuerst einmal: du bist im falschen Board, das gehört eigentlich in das PHP-Board Gibt es einen offensichtlichen Fehler in meinem Code? Wenn es ...

Geschrieben von scatello am 04.08.2025 09:03:59
Forum: HTML, JavaScript, AJAX, jQuery, CSS, Bootstrap, LESS
Probleme mit einfacher Login-Funktion

Hallo zusammen, ich bin neu hier im Forum und auch noch recht frisch im Umgang mit PHP und MySQL. Mein Name ist Lucas, und ich lerne PHP aktuell n ...

Geschrieben von lucasdowman am 04.08.2025 06:54:27
Forum: HTML, JavaScript, AJAX, jQuery, CSS, Bootstrap, LESS
SEO-URLs und MySQL

Die Optimierung von SEO-URLs ist essenziell, um bessere Platzierungen in Suchmaschinen zu erzielen. Beim Umgang mit MySQL sollte man darauf achten ...

Geschrieben von ChristianHolloway am 30.07.2025 06:14:37
Forum: SQL / Datenbanken