DecimalFormat Klasse

Definition

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

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

Vererbung

Object

JavaObject

Object

_Format

NumberFormat

DecimalFormat

Attribute

RegisterAttribute

Hinweise

DecimalFormat ist eine konkrete Unterklasse dieses NumberFormat Formats von Dezimalzahlen. Es verfügt über eine Vielzahl von Features, die es ermöglichen, Zahlen in jedem Gebietsschema zu analysieren und zu formatieren, einschließlich Unterstützung für westliche, arabische und indische Ziffern. Es unterstützt auch verschiedene Arten von Zahlen, einschließlich ganzzahliger Zahlen (123), Festkommazahlen (123,4), wissenschaftlicher Schreibweise (1,23E4), Prozentsätze (12%) und Währungsbeträge (123 USD). All diese können lokalisiert werden.

Rufen Sie zum Abrufen eines NumberFormat für ein bestimmtes Gebietsschema, einschließlich des Standardgebietsschemas, eine der NumberFormatFactorymethoden auf, z getInstance(). B. . Rufen Sie die DecimalFormat Konstruktoren im Allgemeinen nicht direkt auf, da die NumberFormat Factorymethoden unter Umständen andere Unterklassen als DecimalFormat. Wenn Sie das Formatobjekt anpassen müssen, gehen Sie wie folgt vor:

<Blockquote>

NumberFormat f = NumberFormat.getInstance(loc);
            if (f instanceof DecimalFormat) {
                ((DecimalFormat) f).setDecimalSeparatorAlwaysShown(true);
            }

</blockquote>

A DecimalFormat besteht aus einem <Em-Muster>/Em und einer Reihe von <Em-Symbolen><>/Em.<> Das Muster kann direkt mithilfe applyPattern()der API-Methoden oder indirekt mithilfe der API-Methoden festgelegt werden. Die Symbole werden in einem DecimalFormatSymbols Objekt gespeichert. Bei Verwendung der NumberFormat Factorymethoden werden das Muster und die Symbole aus lokalisierten ResourceBundles gelesen.

<h2>Patterns</h2>

DecimalFormat Muster weisen die folgende Syntax auf: <Blockquote>

<i>Pattern:</i>
<i>PositivePattern</i>
<i>PositivePattern</i> ; <i>NegativePattern</i>
<i>PositivePattern:</i>
<i>Prefix<sub>opt</sub></i> <i>Number</i> <i>Suffix<sub>opt</sub></i>
<i>NegativePattern:</i>
<i>Prefix<sub>opt</sub></i> <i>Number</i> <i>Suffix<sub>opt</sub></i>
<i>Prefix:</i>
                    any Unicode characters except &#92;uFFFE, &#92;uFFFF, and special characters
<i>Suffix:</i>
                    any Unicode characters except &#92;uFFFE, &#92;uFFFF, and special characters
<i>Number:</i>
<i>Integer</i> <i>Exponent<sub>opt</sub></i>
<i>Integer</i> . <i>Fraction</i> <i>Exponent<sub>opt</sub></i>
<i>Integer:</i>
<i>MinimumInteger</i>
                    #
                    # <i>Integer</i>
                    # , <i>Integer</i>
<i>MinimumInteger:</i>
                    0
                    0 <i>MinimumInteger</i>
                    0 , <i>MinimumInteger</i>
<i>Fraction:</i>
<i>MinimumFraction<sub>opt</sub></i> <i>OptionalFraction<sub>opt</sub></i>
<i>MinimumFraction:</i>
                    0 <i>MinimumFraction<sub>opt</sub></i>
<i>OptionalFraction:</i>
                    # <i>OptionalFraction<sub>opt</sub></i>
<i>Exponent:</i>
                    E <i>MinimumExponent</i>
<i>MinimumExponent:</i>
                    0 <i>MinimumExponent<sub>opt</sub></i>

</blockquote>

Ein DecimalFormat Muster enthält z. B. einen positiven und negativen Unterpattern. "#,##0.00;(#,##0.00)" Jeder Unterpattern weist ein Präfix, einen numerischen Teil und ein Suffix auf. Die negative Unterpattern ist optional; wenn nicht vorhanden, wird das positive Subpattern mit dem Minuszeichen ('-' U+002D HYPHEN-MINUS) als negative Unterpattern verwendet. Das heißt, "0.00" allein ist gleichbedeutend mit "0.00;-0.00". Wenn eine explizite negative Unterpattern vorhanden ist, dient sie nur dazu, das negative Präfix und Suffix anzugeben; Die Anzahl von Ziffern, minimalen Ziffern und anderen Merkmalen sind mit dem positiven Muster identisch. Das bedeutet, dass "#,##0.0#;(#)" genau das gleiche Verhalten wie "#,##0.0#;(#,##0.0#)".

Die Präfixe, Suffixe und verschiedene Symbole, die für Unendlichkeit, Ziffern, Gruppierungstrennzeichen, Dezimaltrennzeichen usw. verwendet werden, können auf beliebige Werte festgelegt werden, und sie werden während der Formatierung ordnungsgemäß angezeigt. Es muss jedoch darauf geachtet werden, dass die Symbole und Zeichenfolgen nicht in Konflikt stehen oder die Analyse unzuverlässig ist. So müssen z. B. die positiven und negativen Präfixe oder Suffixe voneinander unterschieden DecimalFormat.parse() werden, damit positive Werte von negativen Werten unterschieden werden können. (Wenn sie identisch sind, verhält sich das DecimalFormat Verhalten so, als ob kein negativer Unterpattern angegeben wurde.) Ein weiteres Beispiel ist, dass das Dezimaltrennzeichen und das Gruppierungstrennzeichen unterschiedliche Zeichen sein sollen, oder die Analyse ist unmöglich.

Das Gruppierungstrennzeichen wird häufig für Tausende verwendet, aber in einigen Ländern trennt es zehntausend. Die Gruppierungsgröße ist eine konstante Anzahl von Ziffern zwischen den Gruppierungszeichen, z. B. 3 für 100.000.000 oder 4 für 1.0000.0000. Wenn Sie ein Muster mit mehreren Gruppierungszeichen angeben, ist das Intervall zwischen dem letzten und dem Ende der ganzen Zahl die verwendete. Also "#,##,###,####" == "######,####" == "##,####,####".

<h3>"special_pattern_character">Sondermusterzeichen</h3>

Viele Zeichen in einem Muster werden wörtlich genommen; sie werden während der Analyse und Ausgabe während der Formatierung unverändert abgeglichen. Sonderzeichen dagegen stehen für andere Zeichen, Zeichenfolgen oder Zeichenklassen. Sie müssen zitiert werden, sofern nicht anders angegeben, wenn sie im Präfix oder Suffix als Literale angezeigt werden sollen.

Die hier aufgeführten Zeichen werden in nicht lokalisierten Mustern verwendet. Lokalisierte Muster verwenden stattdessen die entsprechenden Zeichen aus dem Objekt dieses Formatierers DecimalFormatSymbols , und diese Zeichen verlieren ihren Sonderstatus. Zwei Ausnahmen sind das Währungszeichen und das Anführungszeichen, das nicht lokalisiert ist.

<blockquote><table class="striped"><caption style="display:none">Chart showing symbol, location, localized, and meaning.</caption><thead><tr><th scope="col" style="text-align:left">Symbol <th scope="col" style="text-align:left">Location <th scope="col" style="text-align:left">Localized? <th scope="col" style="text-align:left">Meaning /thead<>tbody<>tr style="vertical-align:top"<>th scope="row"<>0td Number <td><>< Digit >tr style="vertical-align: top"<>th scope="row"<>#td Number td<Yes ><td>Digit, zero shows as absent <tr style="vertical-align:top"><th scope="row"><>td Number td Number .td<><>Ja <td-Dezimaltrennzeichen>oder Währungstrennzeichen <tr style="vertical-align: top"><th scope="row">-<td Number >td<Yes >td<>Minuszeichen <tr style="vertical-align:top"><th scope="row">,<td Number td>Number <td><> Grouping separator or monetary grouping separator <tr style="vertical-align: top"><th scope="row">E<td>Zahl <td>Ja <td>Trennt Mantissa und Exponent in der wissenschaftlichen Schreibweise. <em>Muss nicht im Präfix oder Suffix zitiert werden.</em>tr style="vertical-align:top"<>th scope="row"<>;td Subpattern boundary <td>Yes <td><Separates positive und negative subpatterns >tr style="vertical-align: top"<>th scope="row"<>%td Prefix or suffix td<Yes >td<Multiplizieren mit 100 und als Prozentsatz >tr style="vertical-align:top"<>th scope="row"<><td>\u2030Prefix or suffix <>td<>Ja <td>Multiplizieren mit 1000 und als Mille-Wert <tr style="vertical-align: top"><th scope="row">¤ (\u00A4) <td Prefix or suffix >td<>No <td>Currency sign, replaced by currency symbol. Wenn doppelt, wird durch das internationale Währungssymbol ersetzt. Wenn sie in einem Muster vorhanden sind, werden die währungspolitischen Dezimal-/Gruppierungstrennzeichen anstelle der Dezimal-/Gruppierungstrennzeichen verwendet. <tr style="vertical-align:top">th scope="row"<>'td<Prefix or suffix >td No <td><Used to quote special characters in a prefix or suffix, for example, > formats 123 to "'#'#"."#123" Wenn Sie ein einzelnes Anführungszeichen selbst erstellen möchten, verwenden Sie zwei in einer Zeile: "# o''clock". </tbody></table></blockquote>

<h3>Wissenschaftliche Notation</h3>

Zahlen in der wissenschaftlichen Schreibweise werden als Produkt einer Mantissa und einer Potenz von zehn ausgedrückt, beispielsweise kann 1234 als 1,234 x 10^3 ausgedrückt werden. Die Mantissa liegt oft im Bereich 1,0 ≤ x < 10.0, aber es muss nicht sein. DecimalFormatkann angewiesen werden, wissenschaftliche Notation em<nur über ein Muster>/Em< zu formatieren und zu analysieren. Es gibt derzeit keine Factorymethode, die ein wissenschaftliches Notationsformat >erstellt. In einem Muster gibt das Exponentenzeichen unmittelbar gefolgt von einem oder mehreren Ziffern die wissenschaftliche Schreibweise an. Beispiel: "0.###E0" formatiert die Zahl 1234 als "1.234E3".

<ul><li>Die Anzahl der Ziffern nach dem Exponentenzeichen gibt die minimale Anzahl exponentischer Ziffern an. Es gibt kein Maximum. Negative Exponenten werden mit dem lokalisierten Minuszeichen formatiert, <em>not</em> das Präfix und suffix aus dem Muster. Dies ermöglicht Muster wie "0.###E0 m/s"z. B. .

<li>Die minimale und maximale Anzahl ganzzahliger Ziffern werden zusammen interpretiert:

<ul><li>Wenn die maximale Anzahl ganzzahliger Ziffern größer als ihre Mindestzahl und größer als 1 ist, erzwingt der Exponent ein Vielfaches der maximalen Anzahl ganzzahliger Ziffern und die minimale Anzahl ganzzahliger Ziffern, die als 1 interpretiert werden sollen. Die häufigste Verwendung besteht darin, em<engineering notation>/em< zu generieren>, in der der Exponent ein Vielfaches von drei ist, z. B"##0.#####E0". . . Bei Verwendung dieses Musters werden die Zahlen 12345-Formate und "12.345E3"123456 Formaten in "123.456E3".

<li>Andernfalls wird die minimale Anzahl ganzzahliger Ziffern erreicht, indem der Exponent angepasst wird. Beispiel: 0,00123 mit "00.###E0" Ertrag "12.3E-4"formatiert. </ul>

<li>Die Anzahl der signifikanten Ziffern in der Mantissa ist die Summe der <em>minimum integer</em> und <em>maximum fraction</em> digits, and is unaffected by the maximum integer digits. Beispielsweise ist "##0.##E0"12345 formatiert mit "12.3E3" . Um alle Ziffern anzuzeigen, legen Sie die Anzahl der signifikanten Ziffern auf Null fest. Die Anzahl der signifikanten Ziffern wirkt sich nicht auf die Analyse aus.

<li>Exponentielle Muster dürfen keine Gruppierungstrennzeichen enthalten. </ul>

<h3>Rundung</h3>

DecimalFormat stellt Rundungsmodi bereit, die java.math.RoundingMode für die Formatierung definiert sind. Standardmäßig wird verwendet java.math.RoundingMode#HALF_EVEN RoundingMode.HALF_EVEN.

<h3>Ziffern</h3>

Für die Formatierung werden die zehn aufeinander folgenden Zeichen verwendet, DecimalFormat beginnend mit der lokalisierten Nullziffer, die DecimalFormatSymbols im Objekt als Ziffern definiert ist. Bei der Analyse werden diese Ziffern sowie alle Unicode-Dezimalziffern, wie durch Character#digit Character.digitdiese definiert, erkannt.

<h4>Spezialwerte</h4>

NaN ist als Zeichenfolge formatiert, die in der Regel ein einzelnes Zeichen \uFFFDaufweist. Diese Zeichenfolge wird durch das DecimalFormatSymbols Objekt bestimmt. Dies ist der einzige Wert, für den die Präfixe und Suffixe nicht verwendet werden.

Infinity ist als Zeichenfolge formatiert, die in der Regel ein einzelnes Zeichen \u221Ehat, wobei die positiven oder negativen Präfixe und Suffixe angewendet werden. Die Unendlichkeitszeichenfolge wird durch das DecimalFormatSymbols Objekt bestimmt.

Negative Null ("-0") parses to <ul><li>BigDecimal(0) if isParseBigDecimal() is true, <li>Long(0) if isParseBigDecimal() is false and isParseIntegerOnly() is true, <li>Double(-0.0) if both isParseBigDecimal() and isParseIntegerOnly() are false. </ul>

<h3>"synchronization">Synchronization</h3>

Dezimalformate 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.

<h3>(Beispiel</h3)>

<Blockquote>

<strong>{@code
            // Print out a number using the localized number, integer, currency,
            // and percent format for each locale}</strong>{@code
            Locale[] locales = NumberFormat.getAvailableLocales();
            double myNumber = -1234.56;
            NumberFormat form;
            for (int j = 0; j < 4; ++j) {
                System.out.println("FORMAT");
                for (int i = 0; i < locales.length; ++i) {
                    if (locales[i].getCountry().length() == 0) {
                       continue; // Skip language-only locales
                    }
                    System.out.print(locales[i].getDisplayName());
                    switch (j) {
                    case 0:
                        form = NumberFormat.getInstance(locales[i]); break;
                    case 1:
                        form = NumberFormat.getIntegerInstance(locales[i]); break;
                    case 2:
                        form = NumberFormat.getCurrencyInstance(locales[i]); break;
                    default:
                        form = NumberFormat.getPercentInstance(locales[i]); break;
                    }
                    if (form instanceof DecimalFormat) {
                        System.out.print(": " + ((DecimalFormat) form).toPattern());
                    }
                    System.out.print(" -> " + form.format(myNumber));
                    try {
                        System.out.println(" -> " + form.parse(form.format(myNumber)));
                    } catch (ParseException e) {}
                }
            }
            }

</blockquote>

In 1.1 hinzugefügt.

Java Dokumentation für java.text.DecimalFormat.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.