PHP Manual: Create a number formatter

Description

Object-oriented style (method)

public static NumberFormatternull NumberFormatter::create(string $locale, int $style, stringnull $pattern = null)

Procedural style

NumberFormatternull numfmt_create(string $locale, int $style, stringnull $pattern = null)

Object-oriented style (constructor):

public NumberFormatter::__construct(string $locale, int $style, stringnull $pattern = null)

Creates a number formatter.

Parameters

locale: Locale in which the number would be formatted (locale name, e.g. en_CA).
style: Style of the formatting, one of the format style constants. If NumberFormatter::PATTERN_DECIMAL or NumberFormatter::PATTERN_RULEBASED is passed then the number format is opened using the given pattern, which must conform to the syntax described in » ICU DecimalFormat documentation or » ICU RuleBasedNumberFormat documentation, respectively.
pattern: Pattern string if the chosen style requires a pattern.

Return Values

Returns NumberFormatter object or null on error.

Errors/Exceptions

A ValueError is thrown if locale is invalid.

Changelog

Version	Description
8.4.0	A ValueError is thrown if `locale` is invalid.
8.0.0	`pattern` is nullable now.

Examples

Example #1 numfmt_create example

<?php
$fmt = numfmt_create( 'de_DE', NumberFormatter::DECIMAL );
echo numfmt_format($fmt, 1234567.891234567890000)."\n";
$fmt = numfmt_create( 'it', NumberFormatter::SPELLOUT );
echo numfmt_format($fmt, 1142)."\n";
?>

Example #2 NumberFormatter::create example

<?php
$fmt = new NumberFormatter( 'de_DE', NumberFormatter::DECIMAL );
echo $fmt->format(1234567.891234567890000)."\n";
$fmt = new NumberFormatter( 'it', NumberFormatter::SPELLOUT );
echo $fmt->format(1142)."\n";
?>

The above example will output:

1.234.567,891
millicentoquarantadue

NumberFormatter::create

numfmt_create

NumberFormatter::__construct