(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
Les programmes stockent et manipulent des nombres en utilisant une représentation locale, binaire et indépendante. Lors de l'affichage d'un nombre, il est converti en une version particulière. Par exemple, un nombre tel que 12345.67 s'écrit "12,345.67" aux USA, "12 345,67" en France et "12.345,67" en Allemagne.
En appelant les méthodes fournies par NumberFormatter, vous pouvez formater les nombres, les montants de devises et les pourcentages, en fonctions des conventions locales. NumberFormatter prend en compte les conventions, ce qui fait que vous devez créer un nouvel objet NumberFormatter, pour chaque convention. Les méthodes de NumberFormatter, formatent des types primitifs comme des nombres décimaux, et produit une chaîne de caractères.
Pour les monnaies, vous pouvez utiliser le format monétaire pour créer un formateur qui retourne une chaîne, avec le symbole de devise approprié. Bien entendu, NumberFormatter ne connait pas les taux de changes, ce qui fait que l'affichage sera fait, quelqu'en soit la devise demandée. Cela signifie que le même nombre aura différentes valeurs monétaires en fonction de la configuration locale. Par exemple, le nombre 9988776.65 s'affichera :
Pour formater des pourcentages, vous devez créer un formateur local, avec un type de format pourcentage. Avec ce formateur, une fraction décimale telle que 0.75 sera affichée 75%.
Pour des formatages plus complexes, comme des nombres écrits littéralement, des formateurs à règles sont utilisés.
Ces styles sont utilisés par numfmt_create() pour définir le type de formateur.
NumberFormatter::PATTERN_DECIMAL
int
NumberFormatter::DECIMAL
int
NumberFormatter::CURRENCY
int
NumberFormatter::PERCENT
int
NumberFormatter::SCIENTIFIC
int
NumberFormatter::SPELLOUT
int
NumberFormatter::ORDINAL
int
NumberFormatter::DURATION
int
NumberFormatter::PATTERN_RULEBASED
int
NumberFormatter::CURRENCY_ACCOUNTING
int
($3.00)
pour un montant de devise négatif au lieu de
-$3.00
. Disponible à partir de PHP 7.4.1 et ICU 53.
NumberFormatter::DEFAULT_STYLE
int
NumberFormatter::IGNORE
int
Ces constantes définissent la méthode d'analyse et de formatage des nombres. Ils doivent être utilisés comme arguments des fonctions numfmt_format() et numfmt_parse().
NumberFormatter::TYPE_DEFAULT
int
NumberFormatter::TYPE_INT32
int
NumberFormatter::TYPE_INT64
int
NumberFormatter::TYPE_DOUBLE
int
NumberFormatter::TYPE_CURRENCY
int
Attributs de formats de nombre utilisés par numfmt_get_attribute() et numfmt_set_attribute().
NumberFormatter::PARSE_INT_ONLY
int
NumberFormatter::GROUPING_USED
int
NumberFormatter::DECIMAL_ALWAYS_SHOWN
int
NumberFormatter::MAX_INTEGER_DIGITS
int
NumberFormatter::MIN_INTEGER_DIGITS
int
NumberFormatter::INTEGER_DIGITS
int
NumberFormatter::MAX_FRACTION_DIGITS
int
NumberFormatter::MIN_FRACTION_DIGITS
int
NumberFormatter::FRACTION_DIGITS
int
NumberFormatter::MULTIPLIER
int
NumberFormatter::GROUPING_SIZE
int
NumberFormatter::ROUNDING_MODE
int
NumberFormatter::ROUNDING_INCREMENT
int
NumberFormatter::FORMAT_WIDTH
int
NumberFormatter::PADDING_POSITION
int
NumberFormatter::SECONDARY_GROUPING_SIZE
int
NumberFormatter::SIGNIFICANT_DIGITS_USED
int
NumberFormatter::MIN_SIGNIFICANT_DIGITS
int
NumberFormatter::MAX_SIGNIFICANT_DIGITS
int
NumberFormatter::LENIENT_PARSE
int
Attributs de texte pour les formats de nombres, utilisés par numfmt_get_text_attribute() et numfmt_set_text_attribute().
NumberFormatter::POSITIVE_PREFIX
int
NumberFormatter::POSITIVE_SUFFIX
int
NumberFormatter::NEGATIVE_PREFIX
int
NumberFormatter::NEGATIVE_SUFFIX
int
NumberFormatter::PADDING_CHARACTER
int
NumberFormatter::CURRENCY_CODE
int
NumberFormatter::DEFAULT_RULESET
int
NumberFormatter::PUBLIC_RULESETS
int
Les symboles de format utilisés par numfmt_get_symbol() et numfmt_set_symbol().
NumberFormatter::DECIMAL_SEPARATOR_SYMBOL
int
NumberFormatter::GROUPING_SEPARATOR_SYMBOL
int
NumberFormatter::PATTERN_SEPARATOR_SYMBOL
int
NumberFormatter::PERCENT_SYMBOL
int
NumberFormatter::ZERO_DIGIT_SYMBOL
int
NumberFormatter::DIGIT_SYMBOL
int
NumberFormatter::MINUS_SIGN_SYMBOL
int
NumberFormatter::PLUS_SIGN_SYMBOL
int
NumberFormatter::CURRENCY_SYMBOL
int
NumberFormatter::INTL_CURRENCY_SYMBOL
int
NumberFormatter::MONETARY_SEPARATOR_SYMBOL
int
NumberFormatter::EXPONENTIAL_SYMBOL
int
NumberFormatter::PERMILL_SYMBOL
int
NumberFormatter::PAD_ESCAPE_SYMBOL
int
NumberFormatter::INFINITY_SYMBOL
int
NumberFormatter::NAN_SYMBOL
int
NumberFormatter::SIGNIFICANT_DIGIT_SYMBOL
int
NumberFormatter::MONETARY_GROUPING_SEPARATOR_SYMBOL
int
Les modes d'arrondi utilisés par les fonctions numfmt_get_attribute()
et numfmt_set_attribute() avec l'attribut
NumberFormatter::ROUNDING_MODE
.
NumberFormatter::ROUND_AWAY_FROM_ZERO
NumberFormatter::ROUND_UP
.
NumberFormatter::ROUND_CEILING
NumberFormatter::ROUND_DOWN
int
NumberFormatter::ROUND_FLOOR
int
NumberFormatter::ROUND_HALFDOWN
int
NumberFormatter::ROUND_HALFEVEN
int
NumberFormatter::ROUND_HALFODD
NumberFormatter::ROUND_HALFUP
NumberFormatter::ROUND_TOWARD_ZERO
NumberFormatter::ROUND_DOWN
.
NumberFormatter::ROUND_UP
int
Valeurs de compléments utilisés par numfmt_get_attribute()
et numfmt_set_attribute() avec l'attribut
NumberFormatter::PADDING_POSITION
.
NumberFormatter::PAD_AFTER_PREFIX
int
NumberFormatter::PAD_AFTER_SUFFIX
int
NumberFormatter::PAD_BEFORE_PREFIX
int
NumberFormatter::PAD_BEFORE_SUFFIX
int
Version | Description |
---|---|
8.4.0 | Les constantes de classe sont maintenant typées. |