Langue

NumberFormat Classe

Définition

Espace de noms:
Android.Icu.Text
Assembly:
Mono.Android.dll

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

[Android.Runtime.Register("android/icu/text/NumberFormat", ApiSince=24, DoNotGenerateAcw=true)]
public abstract class NumberFormat : Android.Icu.Text.UFormat
[<Android.Runtime.Register("android/icu/text/NumberFormat", ApiSince=24, DoNotGenerateAcw=true)>]
type NumberFormat = class
    inherit UFormat
Héritage
Object
JavaObject
Object
_Format
UFormat
NumberFormat
Dérivé
Attributs
RegisterAttribute

Remarques

<strong>[icu enhancement]</strong> ICU’s replacement for java.text.NumberFormat.  ; Les méthodes, les champs et d’autres fonctionnalités spécifiques à l’ICU sont étiquetées «< strong>[icu]</strong> ».

<fort>IMPORTANT :</fort> Les nouveaux utilisateurs sont fortement encouragés à voir si NumberFormatter leur cas d’usage est adapté. Bien qu’il ne soit pas déconseillé, cette classe, NumberFormat, est fournie uniquement pour la compatibilité java.text.NumberFormat. <hr>

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>

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>

NumberFormat nf = NumberFormat.getInstance();
            for (int i = 0; i &lt; a.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>

NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);

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

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. getPercentInstance Pour obtenir un format permettant d’afficher des pourcentages. Certaines méthodes de fabrique se trouvent dans les sous-classes de NumberFormat. Avec ce format, une fraction telle que 0,53 s’affiche sous la forme 53%.

À partir de l’ICU 4.2, vous pouvez utiliser getInstance() en passant un « style » comme paramètre pour obtenir l’instance correcte. Par exemple, utilisez getInstance(... NUMBERSTYLE) pour obtenir le format de nombre normal, getInstance(... PERCENTSTYLE) pour obtenir un format pour afficher le pourcentage, getInstance(... SCIENTIFICSTYLE) pour obtenir un format pour afficher le nombre scientifique, getInstance(... INTEGERSTYLE) pour obtenir un format de nombre entier, getInstance(... CURRENCYSTYLE) pour obtenir le format de numéro monétaire, dans lequel la devise est représentée par son symbole, par exemple « $3.00 ». getInstance(... ISOCURRENCYSTYLE) pour obtenir le format de numéro monétaire, dans lequel la devise est représentée par son code ISO, par exemple « USD3.00 ». getInstance(... PLURALCURRENCYSTYLE) pour obtenir le format de numéro monétaire, dans lequel la devise est représentée par son nom complet au format pluriel, par exemple « 3,00 dollars US » ou « 1,00 dollar US ».

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 plus de contrôle à vos utilisateurs, vous pouvez essayer de passer des NumberFormat méthodes d’usine à un DecimalFormat. 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 est conçu 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 » -> 3456 (et laisse la position d’analyse juste après '6') si false, « 3456.78 » -> 3456.78 (et laisse la position d’analyse juste après « 8 ») Cela est indépendant de la mise en forme. Si vous ne souhaitez pas afficher un point décimal où il peut y avoir aucun chiffre après le point décimal, utilisez setDecimalSeparatorAlwaysShown sur DecimalFormat.

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 morceaux d’une chaîne >li<> aligner la virgule décimale et d’autres zones </ul> Par exemple, vous pouvez aligner les nombres de deux manières : <ol><li> Si vous utilisez une police monospaced 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 de 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>

<Synchronisation> h3</h3>

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.

<h4>DecimalFormat</h4>

DecimalFormat est l’implémentation concrète de NumberFormat et l’API NumberFormat est essentiellement une abstraction de l’API DecimalFormat. Pour plus d’informations sur cette API, reportez-vous à DecimalFormat.

voir DecimalFormat voir java.text.ChoiceFormat

Java documentation pour android.icu.text.NumberFormat.

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

Constructeurs

Nom Description
NumberFormat()

Constructeur vide.
NumberFormat(IntPtr, JniHandleOwnership)

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

Champs

Nom Description
Accountingcurrencystyle
Obsolète.

<strong>[icu]</strong> Constant pour spécifier le style monétaire de format qui utilise le symbole monétaire pour représenter la devise pour la comptabilité, par exemple : « ($3.
Cashcurrencystyle
Obsolète.

<strong>[icu]</strong> Constant pour spécifier le style monétaire de format qui utilise le code ISO monétaire pour représenter la devise, par exemple : « NT$3 » au lieu de « NT$3 ».
Currencystyle
Obsolète.

<strong>[icu]</strong> Constant pour spécifier le style monétaire général du format.
FractionField
Obsolète.

Constante de champ utilisée pour construire un objet FieldPosition.
IntegerField
Obsolète.

Constante de champ utilisée pour construire un objet FieldPosition.
Integerstyle
Obsolète.

<strong>[icu]</strong> Constant pour spécifier un format de style de nombre entier.
Isocurrencystyle
Obsolète.

<strong>[icu]</strong> Constant pour spécifier le style monétaire du format qui utilise le code ISO monétaire pour représenter la devise, par exemple : « USD3.
Numberstyle
Obsolète.

<strong>[icu]</strong> Constant pour spécifier le style de nombre normal de format.
Percentstyle
Obsolète.

<strong>[icu]</strong> Constant pour spécifier un style de format pour afficher le pourcentage.
Pluralcurrencystyle
Obsolète.

<strong>[icu]</strong> Constant pour spécifier le style monétaire de format qui utilise le nom long monétaire avec le format pluriel pour représenter la devise, par exemple , « 3.
Scientificstyle
Obsolète.

<strong>[icu]</strong> Constant pour spécifier un style de format pour afficher le nombre scientifique.
Standardcurrencystyle
Obsolète.

<strong>[icu]</strong> Constant pour spécifier le style monétaire du format qui utilise le symbole monétaire pour représenter la devise, par exemple « $3 ».

Propriétés

Nom Description
Class

Retourne la classe runtime de ce Object.

(Hérité de Object)
Currency

Retourne l’objet Currency utilisé pour afficher les montants monétaires. -ou- Définit l’objet Currency utilisé pour afficher les montants monétaires.
CurrencyInstance

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GroupingUsed

Retourne true si le regroupement est utilisé dans ce format. -ou- Définit si le regroupement sera utilisé ou non dans ce format.
Handle

Handle de l’instance Android sous-jacente.

(Hérité de Object)
Instance

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
IntegerInstance

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
JniIdentityHashCode

Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité.

(Hérité de Object)
JniManagedPeerState

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

(Hérité de JavaObject)
JniPeerMembers

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.
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

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
ParseIntegerOnly

Retourne true si ce format analyse les nombres sous forme d’entiers uniquement. -ou- Définit s’il faut ignorer la partie fraction d’un nombre lors de l’analyse (valeur par défaut false).
ParseStrict

<strong>[icu]</strong> Renvoie si l’analyse stricte est en vigueur. -ou- <strong>[icu]</strong> Définit si l’analyse stricte est en vigueur.
PeerReference

Obtient la référence d’objet JNI pour cet homologue Java.

(Hérité de Object)
PercentInstance

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
RoundingMode

Retourne le mode d’arrondi utilisé dans ce NumberFormat. -ou- Définissez le mode d’arrondi utilisé dans ce NumberFormat.
ScientificInstance

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
ThresholdClass

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.
ThresholdType

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

Méthodes

Nom Description
Clone()

Crée et retourne une copie de cet objet.

(Hérité de _Format)
Construct(JniObjectReference, JniObjectReferenceOptions)

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

(Hérité de JavaObject)
Dispose()

Libère les ressources détenues par cet homologue Java.

(Hérité de Object)
Dispose(Boolean)

Libère les ressources détenues par cet homologue Java.

(Hérité de Object)
DisposeUnlessReferenced()

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

(Hérité de JavaObject)
Equals(Object)

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

(Hérité de JavaObject)
Equals(Object)

Indique si un autre objet est « égal à » celui-ci.

(Hérité de Object)
Format(BigDecimal, StringBuffer, FieldPosition)

<strong>[icu]</strong> Met en forme un ICU BigDecimal.
Format(BigDecimal, StringBuffer, FieldPosition)

<strong>[icu]</strong> Met en forme un BigDecimal.
Format(BigDecimal)

Méthode pratique pour mettre en forme un BigDecimal.
Format(BigDecimal)

<strong>[icu]</strong> Convenience method to format an ICU BigDecimal.
Format(BigInteger, StringBuffer, FieldPosition)

<strong>[icu]</strong> Met en forme un BigInteger.
Format(BigInteger)

<strong>[icu]</strong> Convenience method to format a BigInteger.
Format(CurrencyAmount, StringBuffer, FieldPosition)

<strong>[icu]</strong> Met en forme un CurrencyAmount.
Format(CurrencyAmount)

<strong>[icu]</strong> Convenience method to format a CurrencyAmount.
Format(Double, StringBuffer, FieldPosition)

Spécialisation du format.
Format(Double)

Spécialisation du format.
Format(Int64, StringBuffer, FieldPosition)

Spécialisation du format.
Format(Int64)

Spécialisation du 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.
Format(Object)

Met en forme un objet pour produire une chaîne.

(Hérité de _Format)
FormatToCharacterIterator(Object)

Met en forme un objet produisant un AttributedCharacterIterator.

(Hérité de _Format)
GetAvailableLocales()

Retourne la liste des paramètres régionaux pour lesquels NumberFormats sont disponibles.
GetContext(DisplayContext+Type)

[icu] Obtenez la valeur DisplayContext du formateur pour le displayContext.Type spécifié, tel que CAPITALIZATION.
GetCurrencyInstance(Locale)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetCurrencyInstance(ULocale)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetHashCode()

Retourne une valeur de code de hachage pour l’objet.

(Hérité de Object)
GetInstance(Locale, NumberFormatStyles)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetInstance(Locale)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetInstance(NumberFormatStyles)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetInstance(ULocale, NumberFormatStyles)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetInstance(ULocale)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetIntegerInstance(Locale)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetIntegerInstance(ULocale)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetNumberInstance(Locale)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetNumberInstance(ULocale)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetPattern(ULocale, Int32)

Retourne le modèle pour les paramètres régionaux et le choix fournis.
GetPercentInstance(Locale)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetPercentInstance(ULocale)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetScientificInstance(Locale)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
GetScientificInstance(ULocale)

< >forte REMARQUE :</les> nouveaux utilisateurs sont fortement encouragés à utiliser NumberFormatter au lieu de NumberFormat.
JavaFinalize()
Obsolète.

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, ParsePosition)

Retourne un type Long si possible (e.
Parse(String)

Analyse le texte à partir du début de la chaîne donnée pour produire un nombre.
ParseCurrency(ICharSequence, ParsePosition)

Analyse le texte de la chaîne donnée en tant que CurrencyAmount.
ParseCurrency(String, ParsePosition)

Analyse le texte de la chaîne donnée en tant que CurrencyAmount.
ParseObject(String, ParsePosition)

Analyse le texte d’une chaîne pour produire un nombre.
ParseObject(String)

Analyse le texte à partir du début de la chaîne donnée pour produire un objet.

(Hérité de _Format)
SetContext(DisplayContext)

<strong>[icu]</strong> Définir une valeur DisplayContext particulière dans le formateur, par exemple CAPITALIZATION_FOR_STANDALONE.
SetHandle(IntPtr, JniHandleOwnership)

Définit la propriété Handle.

(Hérité de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

(Hérité de JavaObject)
ToArray<T>()

Crée un tableau managé à partir de ce wrapper de tableau Java.

(Hérité de Object)
ToString()

Retourne une représentation sous forme de chaîne de l’objet.

(Hérité de Object)
UnregisterFromRuntime()

Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité.

(Hérité de Object)
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, 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)
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)

Implémentations d’interfaces explicites

Nom Description
IJavaPeerable.Disposed()

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

(Hérité de JavaObject)
IJavaPeerable.Finalized()

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

(Hérité de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

(Hérité de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

(Hérité de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

(Hérité de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

(Hérité de JavaObject)
IJavaPeerable.UnregisterFromRuntime()

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.

(Hérité de _Format)

Méthodes d’extension

Nom Description
GetJniTypeName(IJavaPeerable)

Obtient le nom JNI du type de l’instance self.
JavaAs<TResult>(IJavaPeerable)

Essayez de forcer self le typeTResult, en vérifiant que le forçage est valide côté Java.
JavaCast<TResult>(IJavaObject)

Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)

<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour java.text.NumberFormat.
TryJavaCast<TResult>(IJavaPeerable, TResult)

Essayez de forcer self le typeTResult, en vérifiant que le forçage est valide côté Java.

S’applique à