NumberFormatterBase  - AS3 Flex

Le séparateur décimal utilisé pour le formatage ou l’analyse des nombres ayant une partie décimale.

La valeur par défaut dépend des paramètres régionaux et du système d’exploitation.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Définit le jeu de caractères numériques à utiliser lors du formatage des nombres.

Selon les langues et les régions, différents jeux de caractères sont utilisés pour représenter les chiffres de 0 à 9. Cette propriété définit le jeu de chiffres à utiliser.

La valeur de cette propriété représente la valeur Unicode pour le chiffre zéro d’un jeu de chiffres décimaux. Les valeurs valides de cette propriété sont définies dans la classe NationalDigitsType.

La valeur par défaut dépend des paramètres régionaux et du système d’exploitation.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Chaîne de remplacement renvoyée par la méthode format() lorsqu’une erreur se produit.

Si la propriété errorText n’a pas la valeur null et qu’une erreur se produit lors de la mise en forme d’un nombre ou d’un montant en devise, la méthode format renverra la chaîne affectée à cette propriété.

      var nf:NumberFormatter = new NumberFormatter();
      nf.setStyle("locale", "en-US");
      nf.errorText = "###"
      trace(nf.format("abc"));  // ###
      

La valeur par défaut est null.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Nombre maximal de chiffres pouvant apparaître après le séparateur décimal.

Les numéros sont arrondis au nombre de chiffres spécifié par cette propriété. Le modèle d’arrondi varie selon le système d’exploitation de l’utilisateur de l’application.

Lorsque la propriété trailingZeros est définie sur true, la partie fractionnaire du nombre (après le séparateur décimal) est complétée par des zéros non significatifs jusqu’à ce que sa longueur corresponde à la valeur de cette propriété fractionalDigits.

La valeur par défaut dépend des paramètres régionaux et du système d’exploitation.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Décrit le placement des séparateurs de groupes dans la chaîne de nombres formatée.

Lorsque la propriété useGrouping est définie sur true, la propriété groupingPattern permet de définir le placement et le modèle utilisé pour le séparateur de groupes.

Le modèle de groupement est défini en tant que chaîne contenant des numéros séparés par des points-virgules et pouvant se terminer par un astérisque. Par exemple : "3;2;*". Chaque numéro dans la chaîne représente le nombre de chiffres dans un groupe. Le séparateur de groupes est placé avant chaque groupe de chiffres. Un astérisque à la fin de la chaîne indique que les groupes avec ce nombre de chiffres doivent être répétés pour le reste de la chaîne formatée. S’il n’y a pas d’astérisque, il n’y a aucun groupe ou séparateur supplémentaire pour le reste de la chaîne formatée.

Le premier nombre dans la chaîne correspond au premier groupe de chiffres à gauche du séparateur décimal. Les nombres suivants définissent le nombre de chiffres dans les groupes suivants se trouvant à gauche. Ainsi, la chaîne "3;2;*" indique qu’un séparateur de groupes est placé après le premier groupe de 3 chiffres, suivi par des groupes de 2 chiffres. Par exemple : 98,76,54,321

Le tableau ci-dessous présente des exemples de formatage du nombre 123456789.12 avec divers modèles de groupement. Le séparateur de groupes est une virgule et le séparateur décimal est un point.

Seul un nombre limité de tailles de groupement peut être défini. Sur certains systèmes d’exploitation, les modèles de groupement ne peuvent contenir que deux nombres et un astérisque. D’autres systèmes d’exploitation peuvent prendre en charge jusqu’à quatre nombres et un astérisque. Pour les modèles sans astérisque, certains systèmes d’exploitation ne prennent en charge qu’un seul nombre, alors que d’autres prennent en charge jusqu’à trois nombres. Si le nombre maximal d’éléments de modèle de groupement est dépassé, d’autres éléments sont ignorés et la propriété lastOperationStatus est définie pour indiquer qu’une valeur de secours est utilisée.

La valeur par défaut dépend des paramètres régionaux et du système d’exploitation.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Caractère ou chaîne utilisé(e) pour le séparateur de groupes.

La valeur de cette propriété est utilisée comme séparateur de groupes lors du formatage des nombres lorsque la propriété useGrouping est définie sur true. Cette propriété est initialement définie en fonction des paramètres régionaux sélectionnés lors de la construction de l’objet formatter.

La valeur par défaut dépend des paramètres régionaux et du système d’exploitation.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Etat de la dernière opération que cet objet de classe a effectuée. La propriété lastOperationStatus est définie chaque fois que le constructeur ou une méthode de cette classe est appelé, ou qu’une autre propriété est définie. Pour les valeurs disponibles, voir la description de chaque méthode.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Indique si un nombre est précédé d’un zéro lorsque celui-ci ne contient aucun nombre entier à gauche du séparateur décimal.

Lorsque cette propriété est définie sur true, un zéro est inséré à gauche du séparateur décimal lors du formatage des valeurs numériques comprises entre -1,0 et 1,0. Lorsque cette propriété est définie sur false, aucun zéro n’est inséré.

Par exemple, si le nombre est 0,321 et que cette propriété est définie sur true, le zéro à gauche est inclus dans la chaîne formatée. Si la propriété est définie sur false, le zéro n’est inclus. Dans ce cas, la chaîne inclut uniquement le séparateur décimal, suivi des chiffres décimaux, tels que ,321.

Le tableau ci-dessous présente des exemples sur la façon dont les nombres sont formatés en fonction des valeurs de cette propriété, ainsi que des propriétés fractionalDigits et trailingZeros associées.

La valeur par défaut dépend des paramètres régionaux et du système d’exploitation.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Symbole négatif à utiliser lors du formatage des valeurs négatives.

Ce symbole est utilisé avec le format de nombre négatif lors du formatage d’un nombre inférieur à zéro. Il n’est pas utilisé dans des formats de nombre négatif qui n’incluent pas de signe négatif (notamment lorsque des nombres négatifs se trouvent entre parenthèses).

Cette propriété est définie sur une valeur par défaut pour les paramètres régionaux sélectionnés lors de la construction de cette classe de formatage. Elle peut être définie sur une valeur de façon à remplacer le paramètre par défaut.

La valeur par défaut dépend des paramètres régionaux et du système d’exploitation.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Indique si un nombre formaté est précédé de zéros.

Lorsque cette propriété est définie sur true, des zéros sont insérés à droite de la partie fractionnaire du nombre formaté, en respectant la limite spécifiée par la propriété fractionalDigits. Lorsque cette propriété est définie sur false, aucun zéro n’est inséré.

Par exemple, si la valeur numérique est 123,4 et que cette propriété est définie sur true, et si la propriété fractionalDigits est définie sur 3, la chaîne formatée comporte des zéros à droite, comme suit : 123,400. Si cette propriété est définie sur false, aucun zéro à droite n’est inclus et la chaîne comporte uniquement le séparateur décimal suivi des chiffres décimaux non nuls, comme suit : 123,4.

Le tableau ci-dessous présente des exemples sur la façon dont les valeurs numériques sont formatées en fonction des valeurs de cette propriété, ainsi que des propriétés fractionalDigits et trailingZeros associées.

La valeur par défaut dépend des paramètres régionaux et du système d’exploitation.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Permet l’utilisation du séparateur de groupes lors du formatage des nombres.

Lorsque la propriété useGrouping est définie sur true, les chiffres sont groupés et délimités par le caractère de séparation de groupes. Par exemple : 123,456,789.22

Lorsque la propriété useGrouping est définie sur false, les chiffres ne sont ni groupés ni séparés. Par exemple : 123456789.22

Le symbole à utiliser en tant que séparateur de groupes est défini par la propriété groupingSeparator. Le nombre de chiffres compris entre les séparateurs de groupes est défini par la propriété groupingPattern.

La valeur par défaut dépend des paramètres régionaux et du système d’exploitation.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Constructeur.