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 NumberFormatter::formatCurrency(float $amount, string $currency): string|false

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

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().

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