数値をフォーマットする

# NumberFormatter::format

# numfmt_format

(PHP 5 >= 5.3.0, PHP 7, PECL intl >= 1.0.0)

NumberFormatter::format -- numfmt_format — 数値をフォーマットする

### 説明

オブジェクト指向型

public NumberFormatter::format ( number `$value` [, int `$type` ] ) : string

手続き型

numfmt_format ( NumberFormatter `$fmt` , number `$value` [, int `$type` ] ) : string

数値をフォーマット規則にしたがってフォーマットします。

### パラメータ

`fmt`

  NumberFormatter オブジェクト。

`value`

  フォーマットする値。integer あるいは float で指定します。その他の型は数値に変換されます。

`type`

  使用する フォーマット形式。

### 返り値

フォーマットした値を文字列で返します。 エラー時には `FALSE` を返します。

### 例

例1 numfmt_format() の例

`<?php
$fmt = numfmt_create( 'de_DE', NumberFormatter::DECIMAL );
$data = numfmt_format($fmt, 1234567.891234567890000);
if(intl_is_failure(numfmt_format($fmt))) {
report_error("Formatter error");
}
?>`

例2 オブジェクト指向の例

`<?php
$fmt = new NumberFormatter( 'de_DE', NumberFormatter::DECIMAL );
$fmt->format(1234567.891234567890000);
if(intl_is_failure($fmt->getErrorCode())) {
report_error("Formatter error");
}
?>`

上の例の出力は以下となります。

    1.234.567,891

### 参考

- numfmt_get_error_code() - フォーマッタの直近のエラーコードを取得する
- numfmt_format_currency() - 通貨の値をフォーマットする
- numfmt_parse() - 数値をパースする