Formatea un valor monetario

# NumberFormatter::formatCurrency

# numfmt_format_currency

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

NumberFormatter::formatCurrency -- numfmt_format_currency — Formatea un valor monetario

### Descripción

Estilo orientado a objetos

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

Estilo procedimental

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

Formatea un valor monetario, según las reglas del formateador.

### Parámetros

`formatter`

  El objeto NumberFormatter.

`amount`

  El valor numérico.

`currency`

  El código ISO 4217 de tres letras de la moneda a utilizar.

### Valores devueltos

La cadena que representa el valor monetario formateado, o `false` si ocurre un error.

### Ejemplos

Ejemplo #1 Ejemplo con numfmt_format_currency(), Estilo procedimental

    <?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";
    ?>

Ejemplo #2 Ejemplo con numfmt_format_currency(), estilo POO

    <?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";
    ?>

El ejemplo anterior mostrará:

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

### Notas

> Nota:

> Los formatos realizables por este método de formateo no pueden utilizar plenamente las posibilidades de la biblioteca ICU subyacente, como por ejemplo el formateo de moneda con un símbolo monetario corto.

> Para utilizarlas plenamente, utilice msgfmt_format_message().

### Ver también

- numfmt_get_error_code() - Obtener el último código de error del formateador
- numfmt_format() - Formatear un número
- numfmt_parse_currency() - Analiza un número monetario
- msgfmt_format_message() - Formatea rápidamente un mensaje

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