round

関数の概要

PHPの round 関数は、小数点以下の数値を四捨五入して丸めるために使われます。例えば、金額の切り捨てや表示用の数値調整など、数値を扱う場面で非常に便利です。整数に限らず、指定した小数点以下の桁数で丸めることも可能です。

パラメータの説明

  • num (float) : 四捨五入したい対象の数値を指定します。
  • precision (int, 任意) : 小数点以下の桁数を指定します。省略すると0になり整数に丸められます。
  • mode (int, 任意) : 丸めのモードを指定します。PHP 5.3.0以降で利用可能です。デフォルトは PHP_ROUND_HALF_UP で、他に PHP_ROUND_HALF_DOWNPHP_ROUND_HALF_EVENPHP_ROUND_HALF_ODD があります。

戻り値

丸められた数値を返します。precision が指定されている場合は、その小数点以下の桁数まで丸めた結果を返します。

使用例

基本的な使い方(小数点以下を0桁に丸める)

echo round(3.5);  // 4
echo round(3.4);  // 3

3.5は四捨五入されて4に、3.4は切り捨てられて3になります。

小数点以下の桁数を指定する

echo round(3.14159, 2);  // 3.14
echo round(3.146, 2);    // 3.15

小数点以下2桁まで丸めたい場合に便利です。3.14159は3.14に、3.146は3.15に丸められます。

丸めモードを変更する

echo round(2.5, 0, PHP_ROUND_HALF_UP);   // 3
echo round(2.5, 0, PHP_ROUND_HALF_DOWN); // 2
echo round(2.5, 0, PHP_ROUND_HALF_EVEN); // 2
echo round(3.5, 0, PHP_ROUND_HALF_ODD);  // 3

丸めモードを指定することで、四捨五入の挙動を細かく制御できます。デフォルトは PHP_ROUND_HALF_UP です。

関連する関数

  • ceil() – 切り上げを行う関数
  • floor() – 切り捨てを行う関数
  • number_format() – 数値をフォーマットし、指定した小数点以下の桁数で文字列を返す

まとめ

PHPの round 関数は、小数点以下を指定した桁数で四捨五入する際に非常に役立ちます。丸めのモードを指定することでより柔軟な処理も可能です。数値の表示や計算結果の調整に欠かせない関数なので、基本の使い方を理解しておくと実務で役立ちます。