Documentación offline PHP master

NumberFormatter::formatCurrency

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

NumberFormatter::formatCurrency

numfmt_format_currency

Formatea un valor monetario

Descripción#

Estilo orientado a objetos

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

Estilo procedimental

```php
numfmt_format_currency(NumberFormatter $formatter, float $amount, string $currency): string

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 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 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#

[!NOTE] 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.

Véase también#

numfmt_get_error_code, numfmt_format, numfmt_parse_currency, msgfmt_format_message