NumberFormatter::parseCurrency

numfmt_parse_currency

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

NumberFormatter::parseCurrency -- numfmt_parse_currencyInterpreta um valor monetário

Descrição

Estilo orientado a objetos

public NumberFormatter::parseCurrency(string $string, string &$currency, int &$offset = null): float|false

Estilo procedural

numfmt_parse_currency(
    NumberFormatter $formatter,
    string $string,
    string &$currency,
    int &$offset = null
): float|false

Interpreta uma string em um valor decimal e uma moeda usando o formatador atual.

Parâmetros

formatter

Objeto NumberFormatter.

currency

Parâmetro que irá receber o nome da moeda (código de moeda de 3 letras ISO 4217).

offset

Deslocamento na string a partir do qual a interpretação será iniciada. Ao retornar, este valor conterá o deslocamento no qual a interpretação terminou.

Valor Retornado

O valor numérico interpretado ou false em caso de erro.

Exemplos

Exemplo #1 Exemplo de numfmt_parse_currency()

<?php
$fmt
= numfmt_create( 'de_DE', NumberFormatter::CURRENCY );
$num = "1.234.567,89\xc2\xa0$";
echo
"Temos ".numfmt_parse_currency($fmt, $num, $curr)." em $curr\n";
?>

Exemplo #2 Exemplo OO

<?php
$fmt
= new NumberFormatter( 'de_DE', NumberFormatter::CURRENCY );
$num = "1.234.567,89\xc2\xa0$";
echo
"Temos ".$fmt->parseCurrency($num, $curr)." em $curr\n";
?>

O exemplo acima produzirá:

Temos 1234567.89 em USD

Veja Também

add a note add a note

User Contributed Notes 2 notes

up
4
info at mm-newmedia dot de
6 years ago
In reply to daniel at danielphenry dot com example note beneath. The given example by Daniel returns false under PHP7.x, which is a normal behavior since NumberFormatter::parseCurrency() is a method for parsing currency strings. It is trying to split up the given string in a float and a currency.

While using strict types under PHP7 the following example makes it more clearer.

<?php
declare(strict_types=1);
namespace
MMNewmedia;

$oParser = new \NumberFormatter('de_DE', \NumberFormatter::CURRENCY);
var_dump($oParser->parseCurrency("1.234.567,89\xc2\xa0€", $currency), $currency));
?>

This example returns: "float(1234567.89) string(3) "EUR"

This is the expected behavior.

The following example runs into a type error, which is absolutely right, since this method is vor parsing strings and not vor formatting floats into currency strings.

<?php
declare(strict_types=1);
namespace
MMNewmedia;

try {
   
$oCurrencyParser = new \NumberFormatter('de_DE', \NumberFormatter::CURRENCY);
   
$currency = 'EUR';
   
var_dump($oCurrencyParser->parseCurrency(1.234, $currency), $currency);
} catch (\
TypeError $oTypeError) {
   
var_dump($oTypeError->getMessage());
}
?>

This example returns "NumberFormatter::parseCurrency() expects parameter 1 to be string, float given".

If you want to parse floats into a currency string use the http://php.net/manual/en/numberformatter.formatcurrency.php method as shown in the next example.

<?php
declare(strict_types=1);
namespace
MMNewmedia;

$oFormatter = new \NumberFormatter('de_DE', \NumberFormatter::CURRENCY);
var_dump($oFormatter->formatCurrency(1234567.89, 'EUR'));
?>

This returns string(17) "1.234.567,89 €" as expected.
up
0
daniel at danielphenry dot com
8 years ago
The given examples confused me a bit. This may be a bit more clear:

$region = 'en_US';
$currency = 'USD';
$formatter = new NumberFormatter($region, NumberFormatter::CURRENCY);
echo $formatter->parseCurrency(12543.67, $currency);

Responds with:

$12,543.67
To Top