Форматирует число

# NumberFormatter::format

# numfmt_format

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

NumberFormatter::format -- numfmt_format — Форматирует число

### Описание

Объектно-ориентированный стиль

public function NumberFormatter::format(int|float `$num`, int `$type` = `NumberFormatter::TYPE_DEFAULT`): string|false

Процедурный стиль

function numfmt_format(NumberFormatter `$formatter`, int|float `$num`, int `$type` = `NumberFormatter::TYPE_DEFAULT`): string|false

Функция форматирует числовое значение по правилами средства форматирования.

### Список параметров

`formatter`

  Объект NumberFormatter.

`num`

  Значение для форматирования. Параметр принимает значения int, float и другие типы, которые преобразовываются в числовое значение.

`type`

  Тип форматирования. Параметр не поддерживает константу `NumberFormatter::TYPE_CURRENCY`; вместо вызова с этим флагом значение валюты форматируют методом NumberFormatter::formatCurrency().

### Возвращаемые значения

Функция возвращает строку, которая содержит отформатированное значение, или `false`, если возникла ошибка.

### Примеры

Пример #1 Пример форматирования числа функцией numfmt_format()

    <?php

    $fmt = numfmt_create('de_DE', NumberFormatter::DECIMAL);
    $data = numfmt_format($fmt, 1234567.891234567890000);
    var_dump($data);

    ?>

Пример #2 Пример форматирования числа в объектно-ориентированном стиле

    <?php

    $fmt = new NumberFormatter( 'de_DE', NumberFormatter::DECIMAL );
    $data = $fmt->format(1234567.891234567890000);
    var_dump($data);

    ?>

Результат выполнения приведённого примера:

    string(13) "1.234.567,891"

### Примечания

> Замечание:

> Этот метод форматирования поддерживает функции базовой библиотеки ICU не на 100 % и, например, не разрешает выбирать формат обозначения валюты: р. или ₽.

> Полную поддержку функций библиотеки даёт функция msgfmt_format_message().

### Смотрите также

- numfmt_get_error_code() - Получает последний код ошибки средства форматирования
- numfmt_format_currency() - Форматирует значение валюты
- numfmt_parse() - Разбирает число
- msgfmt_format_message() - Быстро форматирует сообщение

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open