RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from http://php.net/manual/en/class.numberformatter.php below:

PHP: NumberFormatter - Manual

The NumberFormatter class

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

Introduction

Programs store and operate on numbers using a locale-independent binary representation. When displaying or printing a number it is converted to a locale-specific string. For example, the number 12345.67 is "12,345.67" in the US, "12 345,67" in France and "12.345,67" in Germany.

By invoking the methods provided by the NumberFormatter class, you can format numbers, currencies, and percentages according to the specified or default locale. NumberFormatter is locale-sensitive so you need to create a new NumberFormatter for each locale. NumberFormatter methods format primitive-type numbers, such as double and output the number as a locale-specific string.

For currencies you can use currency format type to create a formatter that returns a string with the formatted number and the appropriate currency sign. Of course, the NumberFormatter class is unaware of exchange rates so, the number output is the same regardless of the specified currency. This means that the same number has different monetary values depending on the currency locale. If the number is 9988776.65 the results will be:

9 988 776,65 € in France
9.988.776,65 € in Germany
$9,988,776.65 in the United States

In order to format percentages, create a locale-specific formatter with percentage format type. With this formatter, a decimal fraction such as 0.75 is displayed as 75%.

For more complex formatting, like spelled-out numbers, the rule-based number formatters are used.

Class synopsis

class NumberFormatter {

}

Changelog Version Description 8.4.0 The class constants are now typed. Table of Contents

NumberFormatter::create — Create a number formatter
NumberFormatter::format — Format a number
NumberFormatter::formatCurrency — Format a currency value
NumberFormatter::getAttribute — Get an attribute
NumberFormatter::getErrorCode — Get formatter's last error code
NumberFormatter::getErrorMessage — Get formatter's last error message
NumberFormatter::getLocale — Get formatter locale
NumberFormatter::getPattern — Get formatter pattern
NumberFormatter::getSymbol — Get a symbol value
NumberFormatter::getTextAttribute — Get a text attribute
NumberFormatter::parse — Parse a number
NumberFormatter::parseCurrency — Parse a currency number
NumberFormatter::setAttribute — Set an attribute
NumberFormatter::setPattern — Set formatter pattern
NumberFormatter::setSymbol — Set a symbol value
NumberFormatter::setTextAttribute — Set a text attribute

giorgio dot liscio at email dot it ¶

14 years ago

this class seems to be painful: it is not, formatting and parsing are highly customizable, but what you probably need is really simple: 
  if you want to localize a number use:
  <?php 

     $a = new \NumberFormatter("it-IT", \NumberFormatter::DECIMAL); 

     echo $a->format(12345.12345) . "<br>"; $a->setAttribute(\NumberFormatter::MIN_FRACTION_DIGITS, 0); 
$a->setAttribute(\NumberFormatter::MAX_FRACTION_DIGITS, 100); echo $a->format(12345.12345) . "<br>"; ?> 


   if you want to print money use: 
  <?php 

     $a = new \NumberFormatter("it-IT", \NumberFormatter::CURRENCY); 

     echo $a->format(12345.12345) . "<br>"; ?> 


   if you have money data stored as (for example) US dollars and you want to print them using the it-IT notation, you need to use 
  <?php 

     $a = new \NumberFormatter("it-IT", \NumberFormatter::CURRENCY); 

     echo $a->formatCurrency(12345, "USD") . "<br>"; ?> 


   another useful example about currency (how to obtain the currency name by a locale string): 
  <?php 

     $frontEndFormatter = new \NumberFormatter("it-IT", \NumberFormatter::CURRENCY); 
$adminFormatter = new \NumberFormatter("en-US", \NumberFormatter::CURRENCY); 
$symbol = $adminFormatter->getSymbol(\NumberFormatter::INTL_CURRENCY_SYMBOL); echo $frontEndFormatter->formatCurrency(12345.12345, $symbol) . "<br>"; 
?>

jimbo2150 at gmail dot com ¶

2 years ago

The NumberFormatter class can be used to convert integer numbers to Roman numerals without a custom function using an array of symbols and associated values: 
  <?phpfunction intToRomanNumeral(int $num) {

     static $nf = new NumberFormatter('@numbers=roman', NumberFormatter::DECIMAL);

     return $nf->format($num);

     } 
  echointToRomanNumeral(2); echo intToRomanNumeral(5); echo intToRomanNumeral(10); echo intToRomanNumeral(50); echo intToRomanNumeral(57); echo intToRomanNumeral(58); echo intToRomanNumeral(100); echo intToRomanNumeral(150); echo intToRomanNumeral(1000); echo intToRomanNumeral(10000); ?>

stan at dragnev dot ca ¶

4 years ago

Here's an example of how to use PATTERN_DECIMAL to print a number with two fraction digits, use () for negative numbers and pad to five characters to the left of the decimal point, using spaces as the padding character: 
  <?php 
  $fmt= new NumberFormatter("en-CA", NumberFormatter::PATTERN_DECIMAL, "* #####.00 ;(* #####.00)");

   echo $fmt->format(-45.1);?>

 


  Note that the ; in the pattern denotes the beginning of a subpattern, which is used for negative numbers. Hence the brackets around the pattern after the semicolon.

sudheer at binaryvibes dot co dot in ¶

14 years ago

Sample script to print number in English. 
  <?php

     $f = new NumberFormatter("en", NumberFormatter::SPELLOUT);

     echo $f->format(123456);?>


   Produces the result:

   one hundred twenty-three thousand four hundred fifty-six

Einenlum ¶

1 year ago

Be aware that (at least with the locale 'fr-FR') NumberFormatter doesn't use spaces. It doesn't even use non breakable spaces (NBSP). It uses narrow non breakable spaces (NNBSP). This broke my tests. 
  <?php 
  $formatter= new NumberFormatter(
'fr-FR',
NumberFormatter::DEFAULT_STYLE
);$value = $formatter->format(100_000); str_replace("\u{202F}", "\u{00A0}", $value);str_replace("\u{202F}", " ", $value);

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4