array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'numberformatter.formatcurrency.php', 1 => 'NumberFormatter::formatCurrency', 2 => 'Formatea un valor monetario', ), 'up' => array ( 0 => 'class.numberformatter.php', 1 => 'NumberFormatter', ), 'prev' => array ( 0 => 'numberformatter.format.php', 1 => 'NumberFormatter::format', ), 'next' => array ( 0 => 'numberformatter.getattribute.php', 1 => 'NumberFormatter::getAttribute', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/intl/numberformatter/format-currency.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

Estilo procedimental

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