NumberFormat Classe

Définition

[Android.Runtime.Register("java/text/NumberFormat", DoNotGenerateAcw=true)]
public abstract class NumberFormat : Java.Text._Format

[<Android.Runtime.Register("java/text/NumberFormat", DoNotGenerateAcw=true)>]
type NumberFormat = class
    inherit _Format

Héritage

Object

Object

_Format

NumberFormat

Dérivé

Java.Text.ChoiceFormat

Java.Text.DecimalFormat

Attributs

RegisterAttribute

Remarques

NumberFormat est la classe de base abstraite pour tous les formats numériques. Cette classe fournit l’interface pour la mise en forme et l’analyse des nombres. NumberFormat fournit également des méthodes pour déterminer quels paramètres régionaux ont des formats de nombres et quels sont leurs noms.

NumberFormat vous permet de mettre en forme et d’analyser des nombres pour tous les paramètres régionaux. Votre code peut être complètement indépendant des conventions de paramètres régionaux pour les décimales, les séparateurs de milliers, ou même les chiffres décimaux particuliers utilisés, ou si le format de nombre est même décimal.

Pour mettre en forme un nombre pour les paramètres régionaux actuels, utilisez l’une des méthodes de classe de fabrique : <blockquote>

{@code
            myString = NumberFormat.getInstance().format(myNumber);
            }

</blockquote> Si vous mettez en forme plusieurs nombres, il est plus efficace d’obtenir le format et de l’utiliser plusieurs fois afin que le système n’ait pas besoin d’extraire les informations sur la langue locale et les conventions de pays plusieurs fois. <blockquote>

{@code
            NumberFormat nf = NumberFormat.getInstance();
            for (int i = 0; i < myNumber.length; ++i) {
                output.println(nf.format(myNumber[i]) + "; ");
            }
            }

</blockquote> Pour mettre en forme un nombre pour un autre paramètre régional, spécifiez-le dans l’appel à getInstance. <blockquote>

{@code
            NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);
            }

</blockquote>

Si les paramètres régionaux contiennent des extensions Unicode « nu » (nombres), les chiffres décimaux et/ou le pays utilisé pour la mise en forme sont substitués.

Vous pouvez également utiliser un NumberFormat pour analyser des nombres : <blockquote>

{@code
            myNumber = nf.parse(myString);
            }

</blockquote> Use getInstance or getNumberInstance to get the normal number format. Permet getIntegerInstance d’obtenir un format de nombre entier. Permet getCurrencyInstance d’obtenir le format de numéro monétaire. Permet getCompactNumberInstance d’obtenir le format numérique compact pour mettre en forme un nombre sous forme plus courte. Par exemple, 2000 peut être mis en forme comme "2K" dans java.util.Locale#US US locale. Permet getPercentInstance d’obtenir un format pour afficher des pourcentages. Avec ce format, une fraction telle que 0,53 est affichée sous forme de 53 %.

Vous pouvez également contrôler l’affichage des nombres avec des méthodes telles que setMinimumFractionDigits. Si vous souhaitez un contrôle encore plus sur le format ou l’analyse, ou si vous souhaitez donner davantage de contrôle à vos utilisateurs, vous pouvez essayer de passer des NumberFormat méthodes d’usine à une DecimalFormat ou CompactNumberFormat en fonction de la méthode d’usine utilisée. Cela fonctionnera pour la grande majorité des paramètres régionaux ; n’oubliez pas de le placer dans un try bloc au cas où vous rencontrez un élément inhabituel.

NumberFormat et DecimalFormat sont conçus de sorte que certains contrôles fonctionnent pour la mise en forme et d’autres fonctionnent pour l’analyse. Voici la description détaillée de chacune de ces méthodes de contrôle,

setParseIntegerOnly : affecte uniquement l’analyse, par exemple, si true, « 3456.78 » &rarr ; 3456 (et laisse la position d’analyse juste après l’index 6) si false, « 3456.78 » &rarr ; 3456.78 (et laisse la position d’analyse juste après l’index 8) Cela est indépendant de la mise en forme. Si vous ne souhaitez pas afficher de décimale où il peut y avoir aucun chiffre après la virgule décimale, utilisez setDecimalSeparatorAlwaysShown.

setDecimalSeparatorAlwaysShown : affecte uniquement la mise en forme, et uniquement là où il peut y avoir aucun chiffre après la virgule décimale, par exemple avec un modèle comme « #,##0.## », par exemple, si true, 3456.00 &rarr ; "3,456." si false, 3456.00 &rarr ; « 3456 » Ceci est indépendant de l’analyse. Si vous souhaitez que l’analyse s’arrête à la virgule décimale, utilisez setParseIntegerOnly.

Vous pouvez également utiliser des formes des parse méthodes et format des méthodes avec ParsePosition lesquelles FieldPosition vous pouvez : <ul><li analyser progressivement les parties d’une chaîne <li>> aligner les décimales et d’autres zones </ul> Par exemple, vous pouvez aligner les nombres de deux manières : <ol><li> Si vous utilisez une police monospaceée avec espacement pour l’alignement, vous pouvez passer le FieldPosition dans votre appel de format, avec field = INTEGER_FIELD. Dans la sortie, getEndIndex est défini sur le décalage entre le dernier caractère de l’entier et le décimal. Ajoutez des espaces (desiredSpaceCount - getEndIndex) à l’avant de la chaîne.

<li> Si vous utilisez des polices proportionnelles, au lieu du remplissage avec des espaces, mesurez la largeur de la chaîne en pixels du début à getEndIndex. Déplacez ensuite le stylet par (desiredPixelWidth - widthToAlignmentPoint) avant de dessiner le texte. Il fonctionne également là où il n’y a pas de décimale, mais peut-être des caractères supplémentaires à la fin, par exemple, avec des parenthèses dans des nombres négatifs : « (12) » pour -12. </ol>

<h2>"synchronization">Synchronization</h2>

Les formats numériques ne sont généralement pas synchronisés. Il est recommandé de créer des instances de format distinctes pour chaque thread. Si plusieurs threads accèdent simultanément à un format, il doit être synchronisé en externe.

Ajouté dans la version 1.1.

Documentation Java pour java.text.NumberFormat.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

Constructeurs

Champs

Propriétés

Méthodes

Implémentations d’interfaces explicites

Méthodes d’extension

S’applique à