【PHP8.x】round関数の使い方

Copy
1<?php
2
3/**
4 * PHPのround関数を使って、数値を「切り上げ」（正の無限大方向へ丸める）る方法を示します。
5 * キーワード「php roundup」に対応する挙動です。
6 * PHP 8以降では、丸めモードをより明確に指定するためにRoundingMode enumが導入されています。
7 */
8function demonstratePhpRoundUp(): void
9{
10    echo "--- round() 関数で正の無限大方向へ丸める (\\RoundingMode::Up) ---\n";
11
12    // 正の数を切り上げる例
13    $num1 = 3.14;
14    // 小数点以下を切り上げ、整数にする (結果: 4)
15    $rounded1 = round($num1, 0, \RoundingMode::Up);
16    echo "round({$num1}, 0, \\RoundingMode::Up) => {$rounded1}\n";
17
18    $num2 = 3.8;
19    // 小数点以下を切り上げ、整数にする (結果: 4)
20    $rounded2 = round($num2, 0, \RoundingMode::Up);
21    echo "round({$num2}, 0, \\RoundingMode::Up) => {$rounded2}\n";
22
23    $num3 = 3.0;
24    // 既に整数なので、切り上げても値は変わらない (結果: 3)
25    $rounded3 = round($num3, 0, \RoundingMode::Up);
26    echo "round({$num3}, 0, \\RoundingMode::Up) => {$rounded3}\n";
27
28    // 負の数を切り上げる例
29    // 負の数では、「正の無限大方向へ丸める」とは0に近づく方向（絶対値が小さくなる方向）を意味します。
30    $num4 = -3.14;
31    // 小数点以下を切り上げ、整数にする (結果: -3)
32    $rounded4 = round($num4, 0, \RoundingMode::Up);
33    echo "round({$num4}, 0, \\RoundingMode::Up) => {$rounded4}\n";
34
35    $num5 = -3.8;
36    // 小数点以下を切り上げ、整数にする (結果: -3)
37    $rounded5 = round($num5, 0, \RoundingMode::Up);
38    echo "round({$num5}, 0, \\RoundingMode::Up) => {$rounded5}\n";
39
40    // 小数点以下の特定の桁数で切り上げる例
41    $num6 = 3.14159;
42    // 小数点以下2桁目で切り上げる (結果: 3.15)
43    $rounded6 = round($num6, 2, \RoundingMode::Up);
44    echo "round({$num6}, 2, \\RoundingMode::Up) => {$rounded6}\n";
45
46    $num7 = -3.14159;
47    // 小数点以下2桁目で切り上げる (結果: -3.14)
48    $rounded7 = round($num7, 2, \RoundingMode::Up);
49    echo "round({$num7}, 2, \\RoundingMode::Up) => {$rounded7}\n";
50}
51
52// サンプルコードを実行します。
53demonstratePhpRoundUp();
54

PHPのround関数は、指定された数値を丸めるために使用される標準関数です。特に「切り上げ」（正の無限大方向へ丸める）を行う場合、PHP 8以降では\RoundingMode::Upという丸めモードを利用します。このモードは、数値が正の場合は通常の切り上げ（例: 3.14が4に）、負の場合は0に近づく方向への切り上げ（例: -3.14が-3に）となります。

関数の最初の引数$numには丸めたい数値を指定します。続く$precision引数で丸める小数点以下の桁数を指定し、0を指定すると整数に丸められます。正の値を指定すると小数点以下の桁数が、負の値を指定すると整数部分の桁数が対象となります。そして、$mode引数に\RoundingMode::Upを指定することで、常に正の無限大方向へ丸める動作が適用されます。

例えば、3.14や3.8を整数に切り上げるとどちらも4になります。負の数-3.14や-3.8を整数に切り上げると、0に近づく方向である-3になります。また、3.14159を小数点以下2桁で切り上げると3.15に、-3.14159を小数点以下2桁で切り上げると-3.14となります。round関数の戻り値は常にfloat型で、丸められた数値が返されます。これにより、様々な要件に応じた数値の切り上げ処理を正確に実現できます。

Copy
1<?php
2
3/**
4 * PHPのround関数を使った基本的な四捨五入の例を示します。
5 *
6 * round関数は、デフォルトのRoundingMode::HalfUp（一般的な四捨五入）で動作します。
7 * 第二引数 $precision で小数点以下の桁数を指定できます。
8 */
9function demonstrateRoundingExamples(): void
10{
11    echo "--- 基本的な四捨五入 (小数点以下を丸めて整数に) ---" . PHP_EOL;
12    // 小数点以下が0.5未満は切り捨て
13    $num1 = 3.4;
14    echo "{$num1} を四捨五入すると: " . round($num1) . PHP_EOL; // 結果: 3
15
16    // 小数点以下が0.5以上は切り上げ
17    $num2 = 3.5;
18    echo "{$num2} を四捨五入すると: " . round($num2) . PHP_EOL; // 結果: 4
19
20    $num3 = 3.6;
21    echo "{$num3} を四捨五入すると: " . round($num3) . PHP_EOL; // 結果: 4
22
23    echo PHP_EOL;
24
25    echo "--- 指定した小数点以下の桁数で四捨五入 ---" . PHP_EOL;
26    // 小数点以下第2位で四捨五入 (第1位まで残す)
27    $num4 = 123.456;
28    echo "{$num4} を小数点以下第2位で四捨五入すると (第1位まで): " . round($num4, 1) . PHP_EOL; // 結果: 123.5
29
30    $num5 = 123.446;
31    echo "{$num5} を小数点以下第2位で四捨五入すると (第1位まで): " . round($num5, 1) . PHP_EOL; // 結果: 123.4
32
33    // 小数点以下第3位で四捨五入 (第2位まで残す)
34    $num6 = 7.892;
35    echo "{$num6} を小数点以下第3位で四捨五入すると (第2位まで): " . round($num6, 2) . PHP_EOL; // 結果: 7.89
36
37    $num7 = 7.896;
38    echo "{$num7} を小数点以下第3位で四捨五入すると (第2位まで): " . round($num7, 2) . PHP_EOL; // 結果: 7.90
39
40    echo PHP_EOL;
41
42    echo "--- 負のprecisionで整数部分を四捨五入 ---" . PHP_EOL;
43    // 1の位で四捨五入 (10の位まで残す)
44    $num8 = 1234.5;
45    echo "{$num8} を1の位で四捨五入すると (10の位まで): " . round($num8, -1) . PHP_EOL; // 結果: 1230
46
47    $num9 = 1235.5;
48    echo "{$num9} を1の位で四捨五入すると (10の位まで): " . round($num9, -1) . PHP_EOL; // 結果: 1240
49
50    // 10の位で四捨五入 (100の位まで残す)
51    $num10 = 5678.9;
52    echo "{$num10} を10の位で四捨五入すると (100の位まで): " . round($num10, -2) . PHP_EOL; // 結果: 5700
53}
54
55// 関数を実行して結果を表示します
56demonstrateRoundingExamples();
57

PHPのround関数は、与えられた数値を指定された方法で四捨五入するために使用されます。この関数は、丸めたい数値である $num、小数点以下の桁数を指定する $precision、そして丸めモードを設定する $mode の三つの引数を取ります。デフォルトでは $precision が 0 に設定されており、数値を最も近い整数に丸めます。この際の丸めモードは、一般的な四捨五入である RoundingMode::HalfUp が適用され、例えば 3.4 は 3 に、3.5 や 3.6 は 4 に丸められます。

$precision に正の整数を指定することで、小数点以下の特定の桁数で四捨五入を行うことができます。例えば、round(123.456, 1) と指定すると、小数点以下第2位で四捨五入が行われ、結果は 123.5 となります。同様に、round(123.446, 1) であれば 123.4 となります。

また、$precision に負の整数を指定することも可能です。これにより、整数部分を特定の桁数で丸めることができます。例えば、round(1234.5, -1) は1の位で四捨五入を行い、結果は 1230 となります。round(1235.5, -1) の場合は 1240 となります。この関数は常に float 型の値を戻り値として返しますので、整数に丸められた場合でも浮動小数点数として扱われます。