NumberFormat Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
NumberFormat ist die abstrakte Basisklasse für alle Zahlenformate.
[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- Vererbung
- Abgeleitet
- Attribute
Hinweise
NumberFormat ist die abstrakte Basisklasse für alle Zahlenformate. Diese Klasse stellt die Schnittstelle zum Formatieren und Analysieren von Zahlen bereit. NumberFormat Stellt außerdem Methoden zum Bestimmen der Gebietsschemas mit Zahlenformaten und deren Namen bereit.
NumberFormat Hilft Ihnen, Zahlen für jedes Gebietsschema zu formatieren und zu analysieren. Ihr Code kann vollständig unabhängig von den Gebietsschemakonventionen für Dezimalzeichen, Tausendertrennzeichen oder sogar die verwendeten dezimalen Ziffern sein oder ob das Zahlenformat sogar dezimal ist.
Um eine Zahl für das aktuelle Gebietsschema zu formatieren, verwenden Sie eine der Factoryklassenmethoden: <Blockquote>
{@code
myString = NumberFormat.getInstance().format(myNumber);
}
</blockquote> Wenn Sie mehrere Zahlen formatieren, ist es effizienter, das Format abzurufen und mehrmals zu verwenden, damit das System die Informationen über die lokale Sprache und die Länderkonventionen nicht mehrmals abrufen muss. <Blockquote>
{@code
NumberFormat nf = NumberFormat.getInstance();
for (int i = 0; i < myNumber.length; ++i) {
output.println(nf.format(myNumber[i]) + "; ");
}
}
</blockquote> To format a number for a different Locale, specify it in the call to getInstance. <Blockquote>
{@code
NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);
}
</blockquote>
Wenn das Gebietsschema Unicode-Erweiterungen "nu" (Zahlen) enthält, werden die dezimalen Ziffern und/oder das für die Formatierung verwendete Land überschrieben.
Sie können auch eine NumberFormat zum Analysieren von Zahlen verwenden: <Blockquote>
{@code
myNumber = nf.parse(myString);
}
</blockquote> Use getInstance or getNumberInstance to get the normal number format. Dient getIntegerInstance zum Abrufen eines ganzzahligen Zahlenformats. Wird getCurrencyInstance verwendet, um das Währungszahlenformat abzurufen. Dient getCompactNumberInstance zum Abrufen des kompakten Zahlenformats zum Formatieren einer Zahl in kürzerer Form. Kann z. B 2000 . wie "2K" in java.util.Locale#US US localeformatiert werden. Dient getPercentInstance zum Abrufen eines Formats zum Anzeigen von Prozentsätzen. Bei diesem Format wird ein Bruchteil wie 0,53 als 53 % angezeigt.
Sie können auch die Anzeige von Zahlen mit z. B. Methoden setMinimumFractionDigitssteuern. Wenn Sie noch mehr Kontrolle über das Format oder die Analyse wünschen oder Ihren Benutzern mehr Kontrolle geben möchten, können Sie versuchen, die NumberFormat von den Factorymethoden in eine DecimalFormat oder CompactNumberFormat je nach verwendeter Factorymethode zu konvertieren. Dies wird für die überwiegende Mehrheit der Gebietsschemas funktionieren; Denken Sie einfach daran, es in einen try Block zu setzen, falls Sie auf eine ungewöhnliche stoßen.
NumberFormat und DecimalFormat sind so konzipiert, dass einige Steuerelemente für die Formatierung funktionieren und andere für die Analyse funktionieren. Im Folgenden finden Sie die detaillierte Beschreibung für jede dieser Steuerelementmethoden:
setParseIntegerOnly : betrifft nur die Analyse, z. B. wenn true, "3456.78" → 3456 (und hinterlässt die Analyseposition direkt nach Index 6), wenn falsch, "3456,78" → 3456.78 (und hinterlässt die Analyseposition direkt nach Index 8) Dies ist unabhängig von der Formatierung. Wenn Sie keinen Dezimalkommapunkt anzeigen möchten, an dem nach dem Dezimalkomma möglicherweise keine Ziffern vorhanden sind, verwenden Sie setDecimalSeparatorAlwaysShown.
setDecimalSeparatorAlwaysShown : betrifft nur die Formatierung und nur, wenn nach dem Dezimalkomma keine Ziffern vorhanden sind, z. B. mit einem Muster wie "#,##0.##", z. B. wenn wahr, 3456.00 → "3,456." wenn falsch, 3456.00 → "3456" Dies ist unabhängig von der Analyse. Wenn Sie die Analyse am Dezimalkomma beenden möchten, verwenden Sie setParseIntegerOnly.
Sie können auch Formen der parse Und format Methoden verwenden ParsePosition und FieldPosition ihnen ermöglichen: <ul<>li> schrittweise durch Teile einer Zeichenfolge <li> ausrichten den Dezimalkommapunkt und andere Bereiche </ul> Beispielsweise können Sie Zahlen auf zwei Arten ausrichten: <ol><li> Wenn Sie eine monospaced Schriftart mit Abstand für die Ausrichtung verwenden, können Sie den FieldPosition Formataufruf übergeben, mit field = INTEGER_FIELD. Bei der Ausgabe getEndIndex wird der Offset zwischen dem letzten Zeichen der ganzen Zahl und dem Dezimalzeichen festgelegt. Fügen Sie Leerzeichen (desiredSpaceCount - getEndIndex) am Anfang der Zeichenfolge hinzu.
<li> Wenn Sie proportionale Schriftarten verwenden, messen Sie anstelle des Abstands mit Leerzeichen die Breite der Zeichenfolge in Pixeln von Anfang an.getEndIndex Verschieben Sie dann den Stift nach (desiredPixelWidth - widthToAlignmentPoint), bevor Sie den Text zeichnen. Es funktioniert auch, wenn es keine Dezimalzahl gibt, aber möglicherweise zusätzliche Zeichen am Ende, z. B. mit Klammern in negativen Zahlen: "(12)" für -12. </ol>
<h2>"synchronization">Synchronization</h2>
Zahlenformate werden in der Regel nicht synchronisiert. Es wird empfohlen, separate Formatinstanzen für jeden Thread zu erstellen. Wenn mehrere Threads gleichzeitig auf ein Format zugreifen, muss es extern synchronisiert werden.
In 1.1 hinzugefügt.
Java-Dokumentation für java.text.NumberFormat.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Konstruktoren
| NumberFormat() |
Alleiniger Konstruktor. |
| NumberFormat(IntPtr, JniHandleOwnership) |
Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen. |
Felder
| FractionField |
Feldkonstante zum Erstellen eines FieldPosition-Objekts. |
| IntegerField |
Feldkonstante zum Erstellen eines FieldPosition-Objekts. |
Eigenschaften
| Class |
Gibt die Laufzeitklasse dieses Werts |
| Currency |
Ruft die Währung ab, die von diesem Zahlenformat beim Formatieren von Währungswerten verwendet wird. -oder- Legt die Währung fest, die von diesem Zahlenformat beim Formatieren von Währungswerten verwendet wird. |
| CurrencyInstance |
Gibt ein Währungsformat für das aktuelle Standardgebietsschema |
| GroupingUsed |
Gibt true zurück, wenn gruppieren in diesem Format verwendet wird. -or- Legen Sie fest, ob gruppieren in diesem Format verwendet wird. |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| Instance |
Gibt ein allgemeines Zahlenformat für das aktuelle Standardgebietsschema |
| IntegerInstance |
Gibt ein ganzzahliges Zahlenformat für das aktuelle Standardgebietsschema |
| JniIdentityHashCode |
|
| JniPeerMembers |
|
| MaximumFractionDigits |
Gibt die maximale Anzahl von Ziffern zurück, die im Bruchteil einer Zahl zulässig sind. -or- Legt die maximale Anzahl von Ziffern fest, die im Bruchteil einer Zahl zulässig sind. |
| MaximumIntegerDigits |
Gibt die maximale Anzahl von Ziffern zurück, die im ganzzahligen Teil einer Zahl zulässig sind. -or- Legt die maximale Anzahl von Ziffern fest, die im ganzzahligen Teil einer Zahl zulässig sind. |
| MinimumFractionDigits |
Gibt die minimale Anzahl von Ziffern zurück, die im Bruchteil einer Zahl zulässig sind. -or- Legt die Mindestanzahl der ziffern fest, die im Bruchteil einer Zahl zulässig sind. |
| MinimumIntegerDigits |
Gibt die minimale Anzahl von Ziffern zurück, die im ganzzahligen Teil einer Zahl zulässig sind. -or- Legt die mindestanzahl der im ganzzahligen Teil einer Zahl zulässigen Ziffern fest. |
| NumberInstance |
Gibt ein allgemeines Zahlenformat für das aktuelle Standardgebietsschema |
| ParseIntegerOnly |
Gibt true zurück, wenn in diesem Format Zahlen nur als ganze Zahlen analysiert werden. -or- Legt fest, ob Zahlen nur als ganze Zahlen analysiert werden sollen. |
| PeerReference |
|
| PercentInstance |
Gibt ein Prozentformat für das aktuelle Standardgebietsschema |
| RoundingMode |
Ruft den |
| ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
| ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
Methoden
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von _Format) |
| Dispose() |
|
| Dispose(Boolean) |
|
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| Format(Double) |
Spezialisierung des Formats. |
| Format(Double, StringBuffer, FieldPosition) |
Spezialisierung des Formats. |
| Format(Int64) |
Spezialisierung des Formats. |
| Format(Int64, StringBuffer, FieldPosition) |
Spezialisierung des Formats. |
| Format(Object) |
Formatiert ein Objekt, um eine Zeichenfolge zu erzeugen. (Geerbt von _Format) |
| Format(Object, StringBuffer, FieldPosition) |
Formatiert eine Zahl und fügt den resultierenden Text an den angegebenen Zeichenfolgenpuffer an. |
| FormatToCharacterIterator(Object) |
Formatiert ein Objekt, das ein |
| GetAvailableLocales() |
Gibt ein wissenschaftliches Format für das aktuelle Standardgebietsschema zurück. |
| GetCurrencyInstance(Locale) |
Gibt ein Währungsformat für das angegebene Gebietsschema zurück. |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| GetInstance(Locale) |
Gibt ein allgemeines Zahlenformat für das angegebene Gebietsschema zurück. |
| GetIntegerInstance(Locale) |
Gibt ein ganzzahliges Zahlenformat für das angegebene Gebietsschema zurück. |
| GetNumberInstance(Locale) |
Gibt ein allgemeines Zahlenformat für das angegebene Gebietsschema zurück. |
| GetPercentInstance(Locale) |
Gibt ein Prozentformat für das angegebene Gebietsschema zurück. |
| JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| Parse(String) |
Analysiert Text vom Anfang der angegebenen Zeichenfolge, um eine Zahl zu erzeugen. |
| Parse(String, ParsePosition) |
Gibt einen Long-Wert zurück (z. B. |
| ParseObject(String) |
Analysiert Text vom Anfang der angegebenen Zeichenfolge, um ein Objekt zu erzeugen. (Geerbt von _Format) |
| ParseObject(String, ParsePosition) |
Analysiert Text aus einer Zeichenfolge, um eine |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| ToArray<T>() |
|
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| UnregisterFromRuntime() |
|
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em> oder <em>unterbrochen</em>.<>< (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.DisposeUnlessReferenced() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniManagedPeerState |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
Erweiterungsmethoden
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
|
| GetJniTypeName(IJavaPeerable) |
|