number_format

関数の概要

PHPの number_format 関数は、数値を見やすい形式に整形するための関数です。主に数値にカンマ区切りや小数点以下の桁数指定などを行い、金額や統計データなどの表示を分かりやすくします。大きな数値を扱う際や、ユーザーに提示する数字のフォーマットを統一したい場合に便利です。

パラメータの説明

  • number(必須):整形したい数値(整数または浮動小数点数)を指定します。
  • decimals(省略可):小数点以下の表示桁数を指定します。省略すると整数値として扱われ、小数点は表示されません。
  • decimal_separator(省略可):小数点の区切り文字を指定します。デフォルトは '.'(ドット)です。
  • thousands_separator(省略可):千の位の区切り文字(カンマなど)を指定します。デフォルトは ','(カンマ)です。

戻り値

指定された数値をフォーマットした文字列を返します。数値ではなく文字列型となるため、数値演算には使えません。主に表示用として用います。

使用例

基本的な使い方

<?php
echo number_format(1234567);
// 出力: 1,234,567
?>

整数の数値に対してカンマ区切りを入れるだけのシンプルな例です。

小数点以下の桁数指定

<?php
echo number_format(1234.5678, 2);
// 出力: 1,234.57
?>

小数点以下2桁まで表示し、四捨五入も自動で行います。

カンマや小数点の区切り文字を変更する

<?php
echo number_format(1234567.8910, 3, ',', '.');
// 出力: 1.234.567,891
?>

千の位の区切りをドット(ピリオド)に、小数点をカンマにするなど、ローカライズされたフォーマットにも対応可能です。

関連する関数

  • sprintf — 文字列の書式を指定して数値をフォーマット
  • round — 数値の丸め処理を行う
  • intval — 数値の整数部分を取得

まとめ

number_format は数値を読みやすく表示するために非常に便利な関数です。金額表示や統計データなど、ユーザーに見せる際のフォーマット整形に最適です。特に小数点以下の桁数や区切り文字の指定も柔軟に行えるため、さまざまなロケールや用途に対応できます。初心者から実務まで幅広く使える基本関数として覚えておくと役立ちます。