# NumberFormatter::formatCurrency

# numfmt_format_currency

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

NumberFormatter::formatCurrency -- numfmt_format_currency — Dar formato a un valor monetario

### Descripción

Estilo orientado a objetos

public NumberFormatter::formatCurrency(float `$value`, string `$currency`): string

Estilo por procedimientos

numfmt_format_currency(NumberFormatter `$fmt`, float `$value`, string `$currency`): string

Dar formato al valor monetario según las reglas del formateador.

### Parámetros

`fmt`

  Objeto NumberFormatter.

`value`

  El valor numérico monetario.

`currency`

  El código 3-letter ISO 4217 de moneda que indica la moneda a usar.

### Valores devueltos

Un string representando el valor de moneda formateado, o `false` en caso de error.

### Ejemplos

Ejemplo #1 Ejemplo de 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";
?>`

Ejemplo #2 Ejemplo orientado a objetos

`<?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 resultado del ejemplo sería:

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

### Ver también

- numfmt_get_error_code() - Obtener el último código de error del formateador
- numfmt_format() - Dar formato a un número
- numfmt_parse_currency() - Procesa un número monetario