関数の概要
PHPのnumber_format関数は、数値を読みやすくするために桁区切り記号（通常はカンマ）を挿入して文字列に変換するための関数です。特に大きな数字を表示する際に、金額や数量を見やすく表現するためによく使われます。
パラメータの説明
- number（必須）: 数値。フォーマットしたい数値を指定します。
- decimals（任意）: 小数点以下の桁数。省略すると小数点以下は表示されません。
- decimal_point（任意）: 小数点に使う文字。デフォルトは「.」です。
- thousands_separator（任意）: 千の位の区切り文字。デフォルトはカンマ「,」です。
戻り値
フォーマットされた文字列を返します。数値が指定された形式に変換され、カンマ区切りや小数点の指定に従った文字列となります。
使用例
基本的な使い方
<?php
echo number_format(1234567);
?>この例では、整数にカンマ区切りが入り「1,234,567」と表示されます。
小数点以下の桁数を指定する例
<?php
echo number_format(12345.6789, 2);
?>小数点以下2桁まで表示し、「12,345.68」と四捨五入された値が返されます。
小数点・区切り文字を独自に指定する例
<?php
echo number_format(1234567.89, 2, '・', '_');
?>この例では、小数点を「・」、千の位の区切りを「_」に変更し、「1_234_567・89」と表示されます。特定のフォーマットが必要な場合に便利です。
関連する関数
- sprintf – 指定したフォーマットで文字列作成
- round – 数値の丸め処理
- floor, ceil – 数値の切り捨て、切り上げ
- intval – 整数への型変換
まとめ
number_format関数は、PHPで数値を見やすい形式に整形するための基本的で重要な関数です。特に通貨表示や大量の数字を扱う場面で活用すると、ユーザーに分かりやすい出力が可能になります。パラメータを活用することで、小数点や区切り文字のカスタマイズも自由に行えるため、実務での利用範囲が広い関数です。
