round arrondir un nombre à virgule

La fonction round() permet d'arrondir un nombre à virgule flottante (float). Nécessite un paramètre au minimum et trois au maximum (float, int, int). Si un nombre est exactement à mi-chemin entre deux nombres entiers, round() sera toujours arrondi. Disponible depuis la version PHP 4.

php// Retourne la valeur arrondi
float round ( float $nombre [, int $precision = 0 [, int $mode = PHP_ROUND_HALF_UP ]] )

Retourne le nombre arrondi de nombre avec la précision de $precision (indique le nombre de chiffres après la virgule), ce paramètre peut être négatif ou du type NULL (par défaut).

Les paramètres

NomDescriptionObligationType
nombreLa chaîne à arrondir.Obligatoirefloat
precisionLe nombre de chiffres après la virgule.Facultatifint
modeUtilisation de constante pour préciser le mode d'arrondi (Tableau ci-dessous).Facultatifint
NomDescription
PHP_ROUND_HALF_UPArrondit nombre avec la précision de precision supérieure de décimal en s'éloignant de zéro lorsqu'il est à mi-chemin. Par exemple, 2.5 deviendra 3 et -2.5 deviendra -3. Ceci est la valeur par défaut.
PHP_ROUND_HALF_DOWNArrondit nombre avec la précision de precision inférieure de décimal en s'approchant de zéro lorsqu'il est à mi-chemin. Par exemple, 2.5 deviendra 2 et -2.5 deviendra -2.
PHP_ROUND_HALF_EVENArrondit nombre avec la précision de precision de décimal vers la prochaine valeur paire.
PHP_ROUND_HALF_ODDArrondit nombre avec la précision de precision de décimal vers la prochaine valeur impaire.

Valeur de retour

Retournera la valeur arrondi après avoir été modifiée.

Exemples d'utilisation

Premier exemple simple avec round()

phpecho round ( 2.4 );                  // Retourne 2
echo round ( 2.5 );                  // Retourne 3
echo round ( 2.6 );                  // Retourne 3
echo round ( 2.6, 0 );              // Retourne 3
echo round ( 2.95583, 2 );      // Retourne 2.96
echo round ( 1041757, -3 );    // Retourne 1042000
echo round ( 4.045, 2 );          // Retourne 4.05
echo round ( 4.055, 2 );          // Retourne 4.06

Deuxième exemple avec le paramètre mode

phpecho round ( 8.5, 0, PHP_ROUND_HALF_UP );          // Retourne 9
echo round ( 8.5, 0, PHP_ROUND_HALF_DOWN );   // Retourne 8
echo round ( 8.5, 0, PHP_ROUND_HALF_EVEN );    // Retourne 9
echo round ( 8.5, 0, PHP_ROUND_HALF_ODD );     // Retourne 8

echo round ( 7.5, 0, PHP_ROUND_HALF_UP );          // Retourne 8
echo round ( 7.5, 0, PHP_ROUND_HALF_DOWN );   // Retourne 7
echo round ( 7.5, 0, PHP_ROUND_HALF_EVEN );    // Retourne 7
echo round ( 7.5, 0, PHP_ROUND_HALF_ODD );     // Retourne 8

Troisième 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 de la fonction

VersionDescription
5.3.0Le paramètre mode a été ajouté.
5.2.7Le fonctionnement interne de round() a été modifié afin d'être conforme au standard C99.

A voir également

  • ceil() - Pour arrondir un nombre supérieur à la valeur.
  • floor() - Pour arrondir un nombre à l'entier inférieur à la valeur.
  • number_format() - Formate un nombre pour l'affichage.

les réactions

Pour laisser un avis, vous devez être inscrit et connecté

Se connecter