NumberFormat Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
<strong>[icu enhancement]</strong> ICU's replacement for 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- Ereditarietà
- Derivato
- Attributi
Commenti
<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat. Metodi, campi e altre funzionalità specifiche dell'ICU sono etichettati come "<strong>[icu]</strong>".
<strong>IMPORTANT:</strong> Gli utenti nuovi sono fortemente invitati a vedere se NumberFormatter si adatta al proprio caso d'uso. Anche se non è deprecato, questa classe, NumberFormat, viene fornita solo per la compatibilità java.text.NumberFormat.
<hr>
NumberFormat è la classe base astratta per tutti i formati numerici. Questa classe fornisce l'interfaccia per la formattazione e l'analisi dei numeri.
NumberFormat fornisce inoltre metodi per determinare le impostazioni locali con formati numerici e i relativi nomi.
NumberFormat consente di formattare e analizzare i numeri per qualsiasi impostazione locale. Il codice può essere completamente indipendente dalle convenzioni delle impostazioni locali per i separatori decimali, le migliaia o anche le cifre decimali specifiche usate o se il formato numerico è pari a decimale.
Per formattare un numero per le impostazioni locali correnti, usare uno dei metodi della classe factory: <blockquote>
myString = NumberFormat.getInstance().format(myNumber);
</blockquote> Se si formattano più numeri, è più efficiente ottenere il formato e usarlo più volte in modo che il sistema non deve recuperare le informazioni relative alla lingua locale e alle convenzioni paese più volte. <blockquote>
NumberFormat nf = NumberFormat.getInstance();
for (int i = 0; i < a.length; ++i) {
output.println(nf.format(myNumber[i]) + "; ");
}
</blockquote> Per formattare un numero per impostazioni locali diverse, specificarlo nella chiamata a getInstance.
<blockquote>
NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);
</blockquote> È anche possibile usare un NumberFormat per analizzare i numeri: <blockquote>
myNumber = nf.parse(myString);
</blockquote> Usare getInstance o getNumberInstance per ottenere il formato numero normale. Usare getIntegerInstance per ottenere un formato numerico intero. Usare getCurrencyInstance per ottenere il formato del numero di valuta. E usare getPercentInstance per ottenere un formato per la visualizzazione delle percentuali. Alcuni metodi factory si trovano all'interno di sottoclassi di NumberFormat. Con questo formato, una frazione come 0,53 viene visualizzata come 53%.
A partire da ICU 4.2, è possibile usare getInstance() passando uno "style" come parametro per ottenere l'istanza corretta. Ad esempio, usare getInstance(... NUMBERSTYLE) per ottenere il formato numerico normale, getInstance(... PERCENTSTYLE) per ottenere un formato per la visualizzazione della percentuale, getInstance(... SCIENTIFICSTYLE) per ottenere un formato per la visualizzazione del numero scientifico, getInstance(... INTEGERSTYLE) per ottenere un formato di numero intero, getInstance(... CURRENCYSTYLE) per ottenere il formato del numero di valuta, in cui la valuta è rappresentata dal simbolo, ad esempio "$3,00". getInstance(... ISOCURRENCYSTYLE) per ottenere il formato del numero di valuta, in cui la valuta è rappresentata dal codice ISO, ad esempio "USD3.00". getInstance(... PLURALCURRENCYSTYLE) per ottenere il formato del numero di valuta, in cui la valuta è rappresentata dal nome completo in formato plurale, ad esempio "3,00 dollari USA" o "1,00 dollari USA".
È anche possibile controllare la visualizzazione dei numeri con metodi come setMinimumFractionDigits. Se si vuole un maggiore controllo sul formato o sull'analisi o si vuole assegnare agli utenti un maggiore controllo, è possibile provare a eseguire il cast dell'oggetto NumberFormat ottenuto dai metodi factory a un oggetto DecimalFormat. Questo funzionerà per la maggior parte delle impostazioni locali; ricordarsi di metterlo in un try blocco nel caso in cui si incontra un insolito.
NumberFormat è progettato in modo che alcuni controlli funzionino per la formattazione e altri funzionino per l'analisi. Di seguito è riportata la descrizione dettagliata per ognuno di questi metodi di controllo,
setParseIntegerOnly: influisce solo sull'analisi, ad esempio se true, "3456.78" -> 3456 (e lascia la posizione di analisi subito dopo '6') se false, "3456.78" -> 3456.78 (e lascia la posizione di analisi subito dopo '8') Questo è indipendente dalla formattazione. Se si desidera non visualizzare un separatore decimale in cui potrebbero non essere presenti cifre dopo il separatore decimale, usare setDecimalSeparatorAlwaysShown in DecimalFormat.
È anche possibile utilizzare forme dei parse metodi e format con ParsePosition e FieldPosition per consentire l'analisi <progressiva di ul><li attraverso parti di una stringa >li< allineare il separatore decimale e altre aree >/ul<, ad esempio, è possibile allineare i numeri in due modi: >ol<>li<> Se si utilizza un tipo di carattere monospaced con spaziatura per l'allineamento, è possibile passare la FieldPosition chiamata al formato, con field = INTEGER_FIELD. Nell'output getEndIndex , verrà impostato sull'offset tra l'ultimo carattere dell'intero e il decimale. Aggiungere gli spazi (desiredSpaceCount - getEndIndex) nella parte anteriore della stringa.
<li> Se si usano tipi di carattere proporzionali, invece di riempimento con spazi, misurare la larghezza della stringa in pixel dall'inizio a getEndIndex. Spostare quindi la penna in base a (desiredPixelWidth - widthToAlignmentPoint) prima di disegnare il testo. Funziona anche dove non è presente alcun separatore decimale, ma eventualmente caratteri aggiuntivi alla fine, ad esempio con parentesi in numeri negativi: "(12)" per -12.
</ol>
<h3>Synchronization</h3>
I formati numerici in genere non vengono sincronizzati. È consigliabile creare istanze di formato separate per ogni thread. Se più thread accedono contemporaneamente a un formato, deve essere sincronizzato esternamente.
<h4>DecimalFormat</h4>
DecimalFormat è l'implementazione concreta di NumberFormat e l'API NumberFormat è essenzialmente un'astrazione dall'API di DecimalFormat. Per altre informazioni su questa API, vedere DecimalFormat.
vedere DecimalFormat vedere java.text.ChoiceFormat
per android.icu.text.NumberFormat.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.
Costruttori
| Nome | Descrizione |
|---|---|
| NumberFormat() |
Costruttore vuoto. |
| NumberFormat(IntPtr, JniHandleOwnership) |
<strong>[icu enhancement]</strong> ICU's replacement for |
Campi
| Nome | Descrizione |
|---|---|
| Accountingcurrencystyle |
Obsoleti.
<strong>[icu]</strong> Constant per specificare lo stile di valuta del formato che usa il simbolo di valuta per rappresentare la valuta per la contabilità, ad esempio: "($3. |
| Cashcurrencystyle |
Obsoleti.
<strong>[icu]</strong> Constant per specificare lo stile di valuta di formato che usa il codice ISO valuta per rappresentare la valuta, ad esempio" "NT$3" anziché "NT$3". |
| Currencystyle |
Obsoleti.
<strong>[icu]</strong> Constant per specificare lo stile di valuta generale del formato. |
| FractionField |
Obsoleti.
Costante Field utilizzata per costruire un oggetto FieldPosition. |
| IntegerField |
Obsoleti.
Costante Field utilizzata per costruire un oggetto FieldPosition. |
| Integerstyle |
Obsoleti.
<strong>[icu]</strong> Constant per specificare un formato di stile numero intero. |
| Isocurrencystyle |
Obsoleti.
<strong>[icu]</strong> Constant per specificare lo stile di valuta del formato che usa il codice ISO valuta per rappresentare la valuta, ad esempio: "USD3. |
| Numberstyle |
Obsoleti.
<strong>[icu]</strong> Constant per specificare lo stile del numero normale di formato. |
| Percentstyle |
Obsoleti.
<strong>[icu]</strong> Constant per specificare uno stile di formato da visualizzare per percentuale. |
| Pluralcurrencystyle |
Obsoleti.
<strong>[icu]</strong> Constant per specificare lo stile di valuta del formato che usa il nome lungo valuta con formato plurale per rappresentare la valuta, ad esempio "3. |
| Scientificstyle |
Obsoleti.
<strong>[icu]</strong> Constant per specificare uno stile di formato per visualizzare il numero scientifico. |
| Standardcurrencystyle |
Obsoleti.
<strong>[icu]</strong> Constant per specificare lo stile di valuta del formato che usa il simbolo di valuta per rappresentare la valuta, ad esempio "$3. |
Proprietà
| Nome | Descrizione |
|---|---|
| Class |
Restituisce la classe di runtime di questo |
| Currency |
Restituisce l'oggetto |
| CurrencyInstance |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GroupingUsed |
Restituisce true se il raggruppamento viene utilizzato in questo formato. -oppure- Imposta se il raggruppamento verrà utilizzato o meno in questo formato. |
| Handle |
Handle per l'istanza di Android sottostante. (Ereditato da Object) |
| Instance |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| IntegerInstance |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| JniIdentityHashCode |
Ottiene il codice hash di identità assegnato a questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| JniPeerMembers |
<strong>[icu enhancement]</strong> ICU's replacement for |
| MaximumFractionDigits |
Restituisce il numero massimo di cifre consentite nella parte frazionaria di un numero. -oppure- Imposta il numero massimo di cifre consentite nella parte frazionaria di un numero. |
| MaximumIntegerDigits |
Restituisce il numero massimo di cifre consentite nella parte intera di un numero. -oppure- Imposta il numero massimo di cifre consentite nella parte intera di un numero. |
| MinimumFractionDigits |
Restituisce il numero minimo di cifre consentite nella parte frazionaria di un numero. -oppure- Imposta il numero minimo di cifre consentite nella parte frazionaria di un numero. |
| MinimumIntegerDigits |
Restituisce il numero minimo di cifre consentite nella parte integer di un numero. -oppure- Imposta il numero minimo di cifre consentite nella parte integer di un numero. |
| NumberInstance |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| ParseIntegerOnly |
Restituisce true se questo formato analizza i numeri solo come numeri interi. -oppure- Imposta se ignorare la parte frazionaria di un numero durante l'analisi (il valore predefinito è false). |
| ParseStrict |
<strong>[icu]</strong> Restituisce se l'analisi rigorosa è attiva. -oppure- <strong>[icu]</strong> Imposta se l'analisi rigorosa è attiva. |
| PeerReference |
Ottiene il riferimento all'oggetto JNI per questo peer Java. (Ereditato da Object) |
| PercentInstance |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| RoundingMode |
Restituisce la modalità di arrotondamento utilizzata in questo oggetto NumberFormat. -oppure- Impostare la modalità di arrotondamento usata in questo formato NumberFormat. |
| ScientificInstance |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| ThresholdClass |
<strong>[icu enhancement]</strong> ICU's replacement for |
| ThresholdType |
<strong>[icu enhancement]</strong> ICU's replacement for |
Metodi
| Nome | Descrizione |
|---|---|
| Clone() |
Crea e restituisce una copia di questo oggetto. (Ereditato da _Format) |
| Dispose() |
Rilascia le risorse contenute in questo peer Java. (Ereditato da Object) |
| Dispose(Boolean) |
Rilascia le risorse contenute in questo peer Java. (Ereditato da Object) |
| Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
| Format(BigDecimal, StringBuffer, FieldPosition) |
<strong>[icu]</strong> Formatta un ICU BigDecimal. |
| Format(BigDecimal, StringBuffer, FieldPosition) |
<strong>[icu]</strong> Formatta un BigDecimal. |
| Format(BigDecimal) |
Metodo pratico per formattare un Oggetto BigDecimal. |
| Format(BigDecimal) |
<metodo strong>[icu]</strong> Convenience per formattare un ICU BigDecimal. |
| Format(BigInteger, StringBuffer, FieldPosition) |
<strong>[icu]</strong> Formatta un BigInteger. |
| Format(BigInteger) |
<metodo strong>[icu]</strong> Convenience per formattare un BigInteger. |
| Format(CurrencyAmount, StringBuffer, FieldPosition) |
<strong>[icu]</strong> Formatta un currencyAmount. |
| Format(CurrencyAmount) |
<metodo strong>[icu]</strong> Convenience per formattare un currencyAmount. |
| Format(Double, StringBuffer, FieldPosition) |
Specializzazione del formato. |
| Format(Double) |
Specializzazione del formato. |
| Format(Int64, StringBuffer, FieldPosition) |
Specializzazione del formato. |
| Format(Int64) |
Specializzazione del formato. |
| Format(Object, StringBuffer, FieldPosition) |
Formatta un numero e accoda il testo risultante al buffer di stringa specificato. |
| Format(Object) |
Formatta un oggetto per produrre una stringa. (Ereditato da _Format) |
| FormatToCharacterIterator(Object) |
Formatta un oggetto che produce un oggetto |
| GetAvailableLocales() |
Restituisce l'elenco delle impostazioni locali per le quali sono disponibili NumberFormats. |
| GetContext(DisplayContext+Type) |
<strong>[icu enhancement]</strong> ICU's replacement for |
| GetCurrencyInstance(Locale) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetCurrencyInstance(ULocale) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetHashCode() |
Restituisce un valore di codice hash per l'oggetto . (Ereditato da Object) |
| GetInstance(Locale, NumberFormatStyles) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetInstance(Locale) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetInstance(NumberFormatStyles) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetInstance(ULocale, NumberFormatStyles) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetInstance(ULocale) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetIntegerInstance(Locale) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetIntegerInstance(ULocale) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetNumberInstance(Locale) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetNumberInstance(ULocale) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetPattern(ULocale, Int32) |
Restituisce il modello per le impostazioni locali e la scelta specificate. |
| GetPercentInstance(Locale) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetPercentInstance(ULocale) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetScientificInstance(Locale) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| GetScientificInstance(ULocale) |
<strong>NOTE:</strong> Gli utenti nuovi sono fortemente invitati a usare |
| JavaFinalize() |
Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object) |
| Notify() |
Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
| NotifyAll() |
Riattiva tutti i thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
| Parse(String, ParsePosition) |
Restituisce un valore Long se possibile (e. |
| Parse(String) |
Analizza il testo dall'inizio della stringa specificata per produrre un numero. |
| ParseCurrency(ICharSequence, ParsePosition) |
Analizza il testo dalla stringa specificata come currencyAmount. |
| ParseCurrency(String, ParsePosition) |
Analizza il testo dalla stringa specificata come currencyAmount. |
| ParseObject(String, ParsePosition) |
Analizza il testo da una stringa per produrre un numero. |
| ParseObject(String) |
Analizza il testo dall'inizio della stringa specificata per produrre un oggetto . (Ereditato da _Format) |
| SetContext(DisplayContext) |
<strong>[icu]</strong> Impostare un valore DisplayContext specifico nel formattatore, ad esempio CAPITALIZATION_FOR_STANDALONE. |
| SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
| ToArray<T>() |
Crea una matrice gestita da questo wrapper di matrice Java. (Ereditato da Object) |
| ToString() |
Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object) |
| UnregisterFromRuntime() |
Annulla la registrazione di questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| Wait() |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object) |
| Wait(Int64, Int32) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
| Wait(Int64) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IJavaPeerable.Disposed() |
Notifica al runtime di interoperabilità che il peer gestito è stato eliminato. (Ereditato da Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Rilascia questo Java peer a meno che non venga conservato da un altro riferimento gestito. (Ereditato da Object) |
| IJavaPeerable.Finalized() |
Notifica al runtime di interoperabilità che il peer gestito è stato finalizzato. (Ereditato da Object) |
| IJavaPeerable.JniManagedPeerState |
Ottiene lo stato che descrive la relazione tra questo peer gestito e il relativo riferimento JNI. (Ereditato da Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Imposta il codice hash dell'identità di interoperabilità per questo Java peer. (Ereditato da Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Imposta lo stato peer gestito e JNI per questo peer Java. (Ereditato da Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Imposta il riferimento all'oggetto JNI usato da questo peer gestito. (Ereditato da Object) |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ottiene il nome JNI del tipo dell'istanza |
| JavaAs<TResult>(IJavaPeerable) |
Provare a digitare |
| JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo di tipo controllato dal runtime Android. |
| JavaCast<TResult>(IJavaObject) |
<strong>[icu enhancement]</strong> ICU's replacement for |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Provare a digitare |