Форматирует значение валюты

# NumberFormatter::formatCurrency

# numfmt_format_currency

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

NumberFormatter::formatCurrency -- numfmt_format_currency — Форматирует значение валюты

### Описание

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

public function NumberFormatter::formatCurrency(float `$amount`, string `$currency`): string|false

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

function numfmt_format_currency(NumberFormatter `$formatter`, float `$amount`, string `$currency`): string|false

Форматирует значение валюты в соответствии с правилами форматирования.

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

`formatter`

  Объект NumberFormatter.

`amount`

  Числовое значение валюты.

`currency`

  Трёхбуквенный код валюты ISO 4217, обозначающий используемую валюту.

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

Строка, представляющая форматированное значение валюты или `false`, если возникла ошибка.

### Примеры

Пример #1 Пример использования numfmt_format_currency()

    <?php
    $fmt = numfmt_create( 'de_DE', NumberFormatter::CURRENCY );
    echo numfmt_format_currency($fmt, 1234567.891234567890000, "EUR")."\n";
    echo numfmt_format_currency($fmt, 1234567.891234567890000, "RUR")."\n";
    $fmt = numfmt_create( 'ru_RU', NumberFormatter::CURRENCY );
    echo numfmt_format_currency($fmt, 1234567.891234567890000, "EUR")."\n";
    echo numfmt_format_currency($fmt, 1234567.891234567890000, "RUR")."\n";
    ?>

Пример #2 Пример использования в объектно-ориентированном стиле

    <?php
    $fmt = new NumberFormatter( 'de_DE', NumberFormatter::CURRENCY );
    echo $fmt->formatCurrency(1234567.891234567890000, "EUR")."\n";
    echo $fmt->formatCurrency(1234567.891234567890000, "RUR")."\n";
    $fmt = new NumberFormatter( 'ru_RU', NumberFormatter::CURRENCY );
    echo $fmt->formatCurrency(1234567.891234567890000, "EUR")."\n";
    echo $fmt->formatCurrency(1234567.891234567890000, "RUR")."\n";
    ?>

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

    1.234.567,89 €
    1.234.567,89 RUR
    1 234 567,89€
    1 234 567,89р.

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

> Замечание:

> Форматы, достижимые этим способом форматирования, не могут полностью использовать возможности базовой библиотеки ICU, например, форматировать валюту с узким символом валюты.

> Для полной поддержки, используйте функцию msgfmt_format_message().

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

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

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