NumberFormat Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
NumberFormat est la classe de base abstraite pour tous les formats numériques.
[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
- Dérivé
- Attributs
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
| NumberFormat() |
Constructeur unique. |
| NumberFormat(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
Champs
| FractionField |
Constante de champ utilisée pour construire un objet FieldPosition. |
| IntegerField |
Constante de champ utilisée pour construire un objet FieldPosition. |
Propriétés
| Class |
Retourne la classe runtime de ce |
| Currency |
Obtient la devise utilisée par ce format de nombre lors de la mise en forme des valeurs monétaires. -ou- Définit la devise utilisée par ce format de nombre lors de la mise en forme des valeurs monétaires. |
| CurrencyInstance |
Retourne un format monétaire pour les paramètres régionaux par défaut |
| GroupingUsed |
Retourne true si le regroupement est utilisé dans ce format. -ou- Définissez si le regroupement sera utilisé ou non dans ce format. |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| Instance |
Retourne un format de nombre universel pour les paramètres régionaux par défaut |
| IntegerInstance |
Retourne un format de nombre entier pour les paramètres régionaux par défaut |
| JniIdentityHashCode |
|
| JniPeerMembers |
|
| MaximumFractionDigits |
Retourne le nombre maximal de chiffres autorisés dans la partie fraction d’un nombre. -ou- Définit le nombre maximal de chiffres autorisés dans la partie fraction d’un nombre. |
| MaximumIntegerDigits |
Retourne le nombre maximal de chiffres autorisés dans la partie entière d’un nombre. -ou- Définit le nombre maximal de chiffres autorisés dans la partie entière d’un nombre. |
| MinimumFractionDigits |
Retourne le nombre minimal de chiffres autorisés dans la partie fraction d’un nombre. -ou- Définit le nombre minimal de chiffres autorisés dans la partie fraction d’un nombre. |
| MinimumIntegerDigits |
Retourne le nombre minimal de chiffres autorisés dans la partie entière d’un nombre. -ou- Définit le nombre minimal de chiffres autorisé dans la partie entière d’un nombre. |
| NumberInstance |
Retourne un format de nombre universel pour les paramètres régionaux par défaut |
| ParseIntegerOnly |
Retourne true si ce format analyse les nombres sous forme d’entiers uniquement. -ou- Définit si les nombres doivent être analysés en tant qu’entiers uniquement. |
| PeerReference |
|
| PercentInstance |
Retourne un format de pourcentage pour les paramètres régionaux par défaut |
| RoundingMode |
Obtient l’élément |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
Méthodes
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de _Format) |
| Dispose() |
|
| Dispose(Boolean) |
|
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| Format(Double) |
Spécialisation du format. |
| Format(Double, StringBuffer, FieldPosition) |
Spécialisation du format. |
| Format(Int64) |
Spécialisation du format. |
| Format(Int64, StringBuffer, FieldPosition) |
Spécialisation du format. |
| Format(Object) |
Met en forme un objet pour produire une chaîne. (Hérité de _Format) |
| Format(Object, StringBuffer, FieldPosition) |
Met en forme un nombre et ajoute le texte résultant à la mémoire tampon de chaîne donnée. |
| FormatToCharacterIterator(Object) |
Met en forme un objet produisant un |
| GetAvailableLocales() |
Retourne un format scientifique pour les paramètres régionaux par défaut actuels. |
| GetCurrencyInstance(Locale) |
Retourne un format monétaire pour les paramètres régionaux spécifiés. |
| GetHashCode() |
Retourne une valeur de code de hachage pour l'objet. (Hérité de Object) |
| GetInstance(Locale) |
Retourne un format de nombre universel pour les paramètres régionaux spécifiés. |
| GetIntegerInstance(Locale) |
Retourne un format de nombre entier pour les paramètres régionaux spécifiés. |
| GetNumberInstance(Locale) |
Retourne un format de nombre universel pour les paramètres régionaux spécifiés. |
| GetPercentInstance(Locale) |
Retourne un format de pourcentage pour les paramètres régionaux spécifiés. |
| JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| Parse(String) |
Analyse le texte à partir du début de la chaîne donnée pour produire un nombre. |
| Parse(String, ParsePosition) |
Retourne un type Long si possible (e. |
| ParseObject(String) |
Analyse le texte à partir du début de la chaîne donnée pour produire un objet. (Hérité de _Format) |
| ParseObject(String, ParsePosition) |
Analyse le texte d’une chaîne pour produire un |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| ToArray<T>() |
|
| ToString() |
Retourne une représentation de chaîne de l'objet. (Hérité de Object) |
| UnregisterFromRuntime() |
|
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
Implémentations d’interfaces explicites
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.DisposeUnlessReferenced() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniManagedPeerState |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
Méthodes d’extension
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
|
| GetJniTypeName(IJavaPeerable) |
|