round
(PHP 4, PHP 5, PHP 7)
round — Arrondit un nombre à virgule flottante
Description
$val
[, int $precision = 0
[, int $mode = PHP_ROUND_HALF_UP
]] )
Retourne la valeur arrondie de val
à la précision precision (nombre de
chiffres après la virgule). Le paramètre precision
peut être négatif ou NULL : c'est sa valeur par défaut.
Note: PHP ne gère pas correctement les chaînes telles que "12 300,2", par défaut. Reportez-vous à la conversion de chaînes.
Liste de paramètres
-
val -
La valeur à arrondir
-
precision -
Le nombre optionnel de décimales à arrondir.
-
mode -
Utilisez une des constantes suivantes pour spécifier le mode d'arrondi.
Constante Description PHP_ROUND_HALF_UPArrondit valà une précisionprecisionsupérieure de décimal en s'éloignant de zéro lorsqu'il est à mi-chemin. Par exemple, 1.5 deviendra 2 et -1.5 deviendra -2.PHP_ROUND_HALF_DOWNArrondit valà une précisionprecisioninférieure de décimal en s'approchant de zéro lorsqu'il est à mi-chemin. Par exemple, 1.5 deviendra 1 et -1.5 deviendra -1.PHP_ROUND_HALF_EVENArrondit valà la précisionprecisionde décimal vers la valeur paire la plus proche.PHP_ROUND_HALF_ODDArrondit valà la précisionprecisionde décimal vers la valeur impaire la plus proche.
Exemples
Exemple #1 Exemple avec round()
<?php
echo round(3.4); // 3
echo round(3.5); // 4
echo round(3.6); // 4
echo round(3.6, 0); // 4
echo round(1.95583, 2); // 1.96
echo round(1241757, -3); // 1242000
echo round(5.045, 2); // 5.05
echo round(5.055, 2); // 5.06
?>
Exemple #2 Exemple avec le paramètre mode
<?php
echo round(9.5, 0, PHP_ROUND_HALF_UP); // 10
echo round(9.5, 0, PHP_ROUND_HALF_DOWN); // 9
echo round(9.5, 0, PHP_ROUND_HALF_EVEN); // 10
echo round(9.5, 0, PHP_ROUND_HALF_ODD); // 9
echo round(8.5, 0, PHP_ROUND_HALF_UP); // 9
echo round(8.5, 0, PHP_ROUND_HALF_DOWN); // 8
echo round(8.5, 0, PHP_ROUND_HALF_EVEN); // 8
echo round(8.5, 0, PHP_ROUND_HALF_ODD); // 9
?>
Exemple #3 Exemple avec les paramètres mode et precision
<?php
/* Utilisation de PHP_ROUND_HALF_UP avec une précision d'une décimale */
echo round( 1.55, 1, PHP_ROUND_HALF_UP); // 1.6
echo round( 1.54, 1, PHP_ROUND_HALF_UP); // 1.5
echo round(-1.55, 1, PHP_ROUND_HALF_UP); // -1.6
echo round(-1.54, 1, PHP_ROUND_HALF_UP); // -1.5
/* Utilisation de PHP_ROUND_HALF_DOWN avec une précision d'une décimale */
echo round( 1.55, 1, PHP_ROUND_HALF_DOWN); // 1.5
echo round( 1.54, 1, PHP_ROUND_HALF_DOWN); // 1.5
echo round(-1.55, 1, PHP_ROUND_HALF_DOWN); // -1.5
echo round(-1.54, 1, PHP_ROUND_HALF_DOWN); // -1.5
/* Utilisation de PHP_ROUND_HALF_EVEN avec une précision d'une décimale */
echo round( 1.55, 1, PHP_ROUND_HALF_EVEN); // 1.6
echo round( 1.54, 1, PHP_ROUND_HALF_EVEN); // 1.5
echo round(-1.55, 1, PHP_ROUND_HALF_EVEN); // -1.6
echo round(-1.54, 1, PHP_ROUND_HALF_EVEN); // -1.5
/* Utilisation de PHP_ROUND_HALF_ODD avec une précision d'une décimale */
echo round( 1.55, 1, PHP_ROUND_HALF_ODD); // 1.5
echo round( 1.54, 1, PHP_ROUND_HALF_ODD); // 1.5
echo round(-1.55, 1, PHP_ROUND_HALF_ODD); // -1.5
echo round(-1.54, 1, PHP_ROUND_HALF_ODD); // -1.5
?>
Historique
| Version | Description |
|---|---|
| 5.3.0 |
Le paramètre mode a été ajouté.
|
| 5.2.7 | Le fonctionnement interne de round() a été modifié afin d'être conforme au standard C99. |
Voir aussi
- ceil() - Arrondit au nombre supérieur
- floor() - Arrondit à l'entier inférieur
- number_format() - Formate un nombre pour l'affichage
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.round.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
