PHPのnumber_format()関数とは？数値を3桁区切りで整形する使い方を解説

PHPのnumber_format()関数は、数値を千の位ごとに区切って整形（フォーマット）するための関数です。金額やアクセス数など、大きな数値を見やすく表示したい場面で広く活用されています。

構文

number_format(num, decimals, decimal_pt, separator)

パラメータ

• num − フォーマット対象となる数値を指定します。

• decimals − 小数点以下の桁数を指定します。省略した場合は「0」として扱われます。

• decimal_pt − 小数点として使用する文字列を指定します。

• separator − 千の位の区切り文字として使用する文字列を指定します。

戻り値

number_format()関数は、フォーマット済みの数値を返します。なお、戻り値は文字列型になる点に注意してください。

使用例

次の例では、大きな数値を3桁区切りで表示しています。

<?php
    echo number_format("10000000");
?>

出力

10,000,000

小数点以下を含むフォーマットの例

第2引数に小数点以下の桁数を指定すると、数値はその桁数で四捨五入された上で整形されます。

<?php
    echo number_format("3999.9", 2);
?>

出力

3,999.90

区切り文字を変更する例

第3引数・第4引数を指定すれば、小数点や桁区切りに任意の文字を使うこともできます。たとえば、スペース区切りのヨーロッパ式表示は次のように記述します。

<?php
    echo number_format(1234567.891, 2, ",", " ");
?>

出力

1 234 567,89

このようにnumber_format()関数を使いこなせば、金額表記や集計データの表示などにおいて、ユーザーにとって読みやすい数値出力を簡単に実現できます。