Paket | flash.globalization |
Klasse | public final class NumberFormatter |
Vererbung | NumberFormatter Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
int
-, uint
- und Number
-Objekte formatieren.
Die NumberFormatter-Klasse verwendet die Daten und Funktionen, die vom Betriebssystem bereitgestellt werden, und ist so konzipiert, dass Zahlen gemäß den Konventionen eines bestimmten Gebietsschemas formatiert werden, basierend auf den Einstellungen des Benutzers und den vom Betriebssystem des Benutzers unterstützten Funktionen. Die Position des Symbols für negative Zeichen, das Dezimalzeichen, das Gruppierungstrennzeichen, das Gruppierungsmuster und andere Elemente des Zahlenformats können je nach Gebietsschema variieren.
Wenn das Betriebssystem das angeforderte Gebietsschema unterstützt, werden die Eigenschaften für die Zahlenformatierung gemäß den Konventionen und Standards für dieses Gebietsschema festgelegt. Wenn das angeforderte Gebietsschema nicht verfügbar ist, werden die Eigenschaften gemäß einer Ausweichlösung oder dem Standardgebietsschema des Systems (abzurufen mit der actualLocaleIDName
-Eigenschaft) eingestellt.
Aufgrund der Verwendung von Benutzereinstellungen, von Formatierungsmustern, die vom Betriebssystem bereitgestellt werden, und von einem Ersatzgebietsschema, falls das angeforderte Gebietsschema nicht unterstützt wird, sehen die Benutzer möglicherweise unterschiedliche Formatierungsergebnisse, selbst wenn sie dasselbe Gebietsschema verwenden.
Eigenschaft | Definiert von | ||
---|---|---|---|
actualLocaleIDName : String [schreibgeschützt]
Der Name der Gebietsschema-ID, die von diesem NumberFormatter-Objekt verwendet wird. | NumberFormatter | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
decimalSeparator : String
Das Dezimaltrennzeichen, das für die Formatierung oder Analyse von Zahlen mit Dezimalteil verwendet wird. | NumberFormatter | ||
digitsType : uint
Definiert den Satz von Ziffernzeichen, die beim Formatieren von Zahlen verwendet werden sollen. | NumberFormatter | ||
fractionalDigits : int
Die Höchstzahl von Ziffern, die nach dem Dezimaltrennzeichen erscheinen können. | NumberFormatter | ||
groupingPattern : String
Beschreibt die Platzierung von Gruppierungstrennzeichen innerhalb des formatierten Zahlenstrings. | NumberFormatter | ||
groupingSeparator : String
Das Zeichen oder der String, das bzw. der als Gruppierungstrennzeichen verwendet wird. | NumberFormatter | ||
lastOperationStatus : String [schreibgeschützt]
Der Status der vorherigen Operation, die dieses NumberFormatter-Objekt ausgeführt hat. | NumberFormatter | ||
leadingZero : Boolean
Gibt an, ob in der formatierten Zahl vorne eine Null angezeigt wird, wenn es keine Ganzzahlen links des Dezimaltrennzeichens gibt. | NumberFormatter | ||
negativeNumberFormat : uint
Ein numerischer Wert, der ein Formatierungsmuster für negative Zahlen angibt. | NumberFormatter | ||
negativeSymbol : String
Das Negativsymbol, das bei der Formatierung negativer Werte verwendet wird. | NumberFormatter | ||
requestedLocaleIDName : String [schreibgeschützt]
Der Name der angeforderten Gebietsschema-ID wurde an den Konstruktor dieses NumberFormatter-Objekts übergeben. | NumberFormatter | ||
trailingZeros : Boolean
Gibt an, ob nachfolgende Nullen in einer formatierten Zahl angezeigt werden. | NumberFormatter | ||
useGrouping : Boolean
Aktiviert die Verwendung des Gruppierungstrennzeichens bei der Formatierung von Zahlen. | NumberFormatter |
Methode | Definiert von | ||
---|---|---|---|
NumberFormatter(requestedLocaleIDName:String)
Konstruiert ein neues NumberFormatter-Objekt, um Zahlen entsprechend den Konventionen eines gegebenen Gebietsschemas zu formatieren. | NumberFormatter | ||
Formatiert einen int-Wert. | NumberFormatter | ||
Formatiert einen Number-Wert. | NumberFormatter | ||
Formatiert einen uint-Wert. | NumberFormatter | ||
[statisch]
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden. | NumberFormatter | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Analysiert einen String und gibt ein NumberParseResult-Objekt zurück, das die analysierten Elemente enthält. | NumberFormatter | ||
Analysiert einen String, der nur Ziffern und optionale Leerraumzeichen enthält und gibt eine Zahl zurück. | NumberFormatter | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
actualLocaleIDName | Eigenschaft |
actualLocaleIDName:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Name der Gebietsschema-ID, die von diesem NumberFormatter-Objekt verwendet wird.
Es drei Möglichkeiten für den Wert des Namens, abhängig vom Betriebssystem und dem Wert des requestedLocaleIDName
-Parameters, der an den Collator()
-Konstruktor übergeben wird.
- Wenn das angeforderte Gebietsschema nicht
LocaleID.DEFAULT
war und das Betriebssystem das angeforderten Gebietsschema unterstützt, ist der zurückgegebene Name identisch mit derrequestedLocaleIDName
-Eigenschaft. - Wenn
LocaleID.DEFAULT
als Wert für denrequestedLocaleIDName
-Parameter an den Konstruktor übergeben wurde, wird der Name des aktuellen Gebietsschemas verwendet, der vom Betriebssystem des Benutzers angegeben wird. DerLocaleID.DEFAULT
-Wert bewahrt die benutzerdefinierten Einstellungen im Betriebssystem. Mit der Übergabe eines expliziten Werts alsrequestedLocaleIDName
-Parameter wird nicht unbedingt dasselbe Ergebnis erzielt wie mit der Verwendung vonLocaleID.DEFAULT
, selbst wenn die beiden Gebietsschema-ID-Namen identisch sind. Der Benutzer hat die Gebietsschemaeinstellungen auf seinem Computer möglicherweise angepasst. Wenn Sie einen expliziten Gebietsschema-ID-Namen anfordern, anstattLocaleID.DEFAULT
zu verwenden, ruft Ihre Anwendung diese benutzerdefinierten Einstellungen nicht ab. - Wenn das System den im Konstruktor angegebenen
requestedLocaleIDName
nicht unterstützt, wird ein Ersatzgebietsschema bereitgestellt.
Implementierung
public function get actualLocaleIDName():String
Verwandte API-Elemente
decimalSeparator | Eigenschaft |
decimalSeparator:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Das Dezimaltrennzeichen, das für die Formatierung oder Analyse von Zahlen mit Dezimalteil verwendet wird.
Diese Eigenschaft wird anfänglich basierend auf dem Gebietsschema, das beim Konstruieren des Formatter-Objekts ausgewählt wurde, festgelegt.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus
-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Der Standardwert ist dependent on the locale and operating system..
Implementierung
public function get decimalSeparator():String
public function set decimalSeparator(value:String):void
Auslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
digitsType | Eigenschaft |
digitsType:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Definiert den Satz von Ziffernzeichen, die beim Formatieren von Zahlen verwendet werden sollen.
Verschiedene Sprachen und Regionen verwenden unterschiedliche Zeichengruppen, um die Ziffern 0 bis 9 darzustellen. Diese Eigenschaft definiert die verwendete Zifferngruppe.
Der Wert dieser Eigenschaft repräsentiert den Unicode-Wert für die Ziffer Null einer dezimalen Zifferngruppe. Die gültigen Werte für diese Eigenschaft sind in der NationalDigitsType-Klasse definiert.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus
-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Der Standardwert ist dependent on the locale and operating system..
Implementierung
public function get digitsType():uint
public function set digitsType(value:uint):void
Auslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
fractionalDigits | Eigenschaft |
fractionalDigits:int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Die Höchstzahl von Ziffern, die nach dem Dezimaltrennzeichen erscheinen können.
Zahlen werden auf die Anzahl von Ziffern gerundet, die mit dieser Eigenschaft angegeben wird. Das Rundungsschema variiert je nach Betriebssystem des Benutzers.
Wenn die trailingZeros
-Eigenschaft den Wert true
hat, werden dem gebrochenen Teil der Zahl (nach dem Dezimalzeichen) Nullen nachgestellt, bis die Länge mit dem Wert dieser fractionalDigits
-Eigenschaft übereinstimmt.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus
-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Der Standardwert ist 0.
Implementierung
public function get fractionalDigits():int
public function set fractionalDigits(value:int):void
Verwandte API-Elemente
groupingPattern | Eigenschaft |
groupingPattern:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Beschreibt die Platzierung von Gruppierungstrennzeichen innerhalb des formatierten Zahlenstrings.
Wenn die useGrouping
-Eigenschaft den Wert „true“ hat, wird die groupingPattern
-Eigenschaft verwendet, um die Platzierung und das Muster für das Gruppierungstrennzeichen zu definieren.
Das Gruppierungsmuster wird als String definiert, der Zahlen enthält, die durch Kommas getrennt sind, und der optional mit einem Asterisk enden kann. Beispiel: "3;2;*"
. Jede Zahl in diesem String repräsentiert die Anzahl der Ziffern in einer Gruppe. Das Gruppierungstrennzeichen wird vor jeder Gruppe von Ziffern platziert. Ein Asterisk am Ende des Strings gibt an, dass Gruppen mit dieser Anzahl von Ziffern für den verbleibenden Rest des Strings wiederholt werden sollen. Fehlt der Asterisk, gibt es im Rest des formatierten Strings keine weiteren Gruppen oder Trennzeichen.
Die erste Zahl im String entspricht der ersten Gruppe von Ziffern links des Dezimaltrennzeichens. Die weiteren Zahlen geben die Anzahl von Ziffern in nach links aufeinander folgenden Gruppen an. Der String "3;2;*" gibt also an, dass ein Gruppierungstrennzeichen nach der ersten Gruppe mit 3 Ziffern gesetzt wird, dann nach der nächsten Gruppe mit 2 Ziffern. Beispiel: 98,76,54,321
In der folgenden Tabelle sind Beispiele für die Formatierung der Zahl 123456789.12 mit verschiedenen Gruppierungsmustern aufgeführt. Als Gruppierungstrennzeichen wird ein Komma, als Dezimalzeichen ein Punkt verwendet.
Gruppierungsmuster | Beispielformat |
3;* | 123,456,789.12 |
3;2;* | 12,34,56,789.12 |
3 | 123456,789.12 |
Es kann nur eine begrenzte Anzahl von Gruppengrößen definiert werden. Bei einigen Betriebssystemen können Gruppierungsmuster nur zwei Zahlen und einen Asterisk enthalten. Andere Betriebssysteme unterstützen bis zu vier Zahlen und einen Asterisk. Bei Mustern ohne Asterisk unterstützen einige Betriebssystem nur eine Zahl, andere bis zu drei Zahlen. Wenn die maximale Anzahl von Elementen in einem Gruppierungsmuster überschritten wird, werden die überzähligen Elemente ignoriert und die lastOperationStatus
-Eigenschaft wird wie unten beschrieben gesetzt.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus
-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Implementierung
public function get groupingPattern():String
public function set groupingPattern(value:String):void
Auslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
groupingSeparator | Eigenschaft |
groupingSeparator:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Das Zeichen oder der String, das bzw. der als Gruppierungstrennzeichen verwendet wird.
Der Wert dieser Eigenschaft wird beim Formatieren von Zahlen mit der useGrouping
-Eigenschaft mit dem Wert true
als Gruppierungstrennzeichen verwendet. Diese Eigenschaft wird anfänglich basierend auf dem Gebietsschema, das beim Konstruieren des Formatter-Objekts ausgewählt wurde, festgelegt.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus
-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Der Standardwert ist dependent on the locale and operating system..
Implementierung
public function get groupingSeparator():String
public function set groupingSeparator(value:String):void
Auslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
lastOperationStatus | Eigenschaft |
lastOperationStatus:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Status der vorherigen Operation, die dieses NumberFormatter-Objekt ausgeführt hat. Die lastOperationStatus
-Eigenschaft wird immer festgelegt, wenn der Konstruktor oder eine Methode dieser Klasse aufgerufen oder eine andere Eigenschaft festgelegt wird. Die möglichen Werte sind in der Beschreibung der einzelnen Methoden aufgeführt.
Implementierung
public function get lastOperationStatus():String
Verwandte API-Elemente
leadingZero | Eigenschaft |
leadingZero:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Gibt an, ob in der formatierten Zahl vorne eine Null angezeigt wird, wenn es keine Ganzzahlen links des Dezimaltrennzeichens gibt.
Wenn diese Eigenschaft auf true
gesetzt ist, wird beim Formatieren von numerischen Werten zwischen -1.0 und 1.0 links des Dezimalzeichens eine Null vorangestellt. Wenn diese Eigenschaft den Wert false
hat, wird keine Null vorangestellt.
Wenn die Zahl zum Beispiel 0.321 lautet und diese Eigenschaft den Wert true
hat, wird die vorangestellte Null in den formatierten String einbezogen. Wenn die Eigenschaft den Wert false
hat, wird keine Null vor das Dezimalzeichen gesetzt. In diesem Fall enthält der String lediglich das Dezimalzeichen, gefolgt von den Dezimalstellen, also .321
.
Die folgende Tabelle enthält Beispiele für die Formatierung von Zahlen anhand der Werte für diese Eigenschaft und die verwandten Eigenschaften fractionalDigits
und trailingZeros
.
trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
true | true | 3 | 0.120 | 0.000 |
false | true | 3 | 0.12 | 0 |
true | false | 3 | .120 | .000 |
false | false | 3 | .12 | 0 |
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus
-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Der Standardwert ist dependent on the locale and operating system..
Implementierung
public function get leadingZero():Boolean
public function set leadingZero(value:Boolean):void
Auslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
negativeNumberFormat | Eigenschaft |
negativeNumberFormat:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Ein numerischer Wert, der ein Formatierungsmuster für negative Zahlen angibt. Dieses Muster definiert die Position des Negativsymbols oder von Klammern in Relation zum numerischen Teil der formatierten Zahl.
In der folgenden Tabelle sind die möglichen Formate für negative Zahlen aufgeführt. Wenn eine negative Zahl formatiert wird, wird das Minuszeichen im Format durch den Wert der negativeSymbol
-Eigenschaft ersetzt und das Zeichen 'n' wird durch den formatierten numerischen Wert ersetzt.
Formattyp für negative Zahlen | Format |
0 | (n) |
1 | -n |
2 | - n |
3 | n- |
4 | n - |
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus
-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Der Standardwert ist dependent on the locale and operating system..
Implementierung
public function get negativeNumberFormat():uint
public function set negativeNumberFormat(value:uint):void
Auslöser
ArgumentError — wenn der zugewiesene Wert keine Zahl zwischen 0 und 4 ist.
|
Verwandte API-Elemente
negativeSymbol | Eigenschaft |
negativeSymbol:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Das Negativsymbol, das bei der Formatierung negativer Werte verwendet wird.
Dieses Symbol wird mit dem Format für negative Zahlen verwendet, wenn die formatierte Zahl kleiner als null ist. Es wird nicht verwendet bei Formaten für negative Zahlen, die kein Negativsymbol enthalten (zum Beispiel, wenn negative Zahlen in Klammern gesetzt werden).
Diese Eigenschaft wird auf einen Standardwert für das tatsächlich verwendete Gebietsschema, das beim Konstruieren des Formatters ausgewählt wurde, gesetzt. Es kann ein Wert festgelegt werden, um die Standardeinstellung zu überschreiben.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus
-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Implementierung
public function get negativeSymbol():String
public function set negativeSymbol(value:String):void
Auslöser
MemoryError — wenn das System nicht genügend internen Speicher zuordnen kann.
|
Verwandte API-Elemente
requestedLocaleIDName | Eigenschaft |
requestedLocaleIDName:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Name der angeforderten Gebietsschema-ID wurde an den Konstruktor dieses NumberFormatter-Objekts übergeben.
Wenn der Wert LocaleID.DEFAULT
verwendet wurde, lautet der zurückgegebene Name "i-default". Das tatsächlich verwendete Gebietsschema kann vom angeforderten Gebietsschema abweichen, wenn ein Ersatzgebietsschema verwendet wird. Der Name des tatsächlich verwendeten Gebietsschemas kann mit der actualLocaleIDName
-Eigenschaft abgerufen werden.
Implementierung
public function get requestedLocaleIDName():String
Verwandte API-Elemente
trailingZeros | Eigenschaft |
trailingZeros:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Gibt an, ob nachfolgende Nullen in einer formatierten Zahl angezeigt werden.
Wenn diese Eigenschaft den Wert true
hat, werden nachfolgende Nullen in den gebrochenen Teil der formatierten Zahl eingeschlossen, und zwar bis zu dem Grenzwert, der mit der fractionalDigits
-Eigenschaft festgelegt wurde. Wenn diese Eigenschaft den Wert false
hat, werden keine nachfolgenden Nullen hinzugefügt.
Lautet der numerische Wert beispielsweise 123.4 und diese Eigenschaft hat den Wert „true“, während die fractionalDigits
-Eigenschaft auf „3“ eingestellt ist, werden im formatierten String nachfolgende Nullen bis zur dritten Dezimalstelle angezeigt, also 123.400
. Wenn diese Eigenschaft den Wert false
hat, werden keine nachfolgenden Nullen angezeigt und der String zeigt nur das Dezimalzeichen, gefolgt von den Dezimalstellen, die nicht null sind, also 123.4
.
Die folgende Tabelle enthält Beispiele für die Formatierung von numerischen Werten anhand der Werte für diese Eigenschaft und die verwandten Eigenschaften fractionalDigits
und leadingZero
.
trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
true | true | 3 | 0.120 | 0.000 |
false | true | 3 | 0.12 | 0 |
true | false | 3 | .120 | .000 |
false | false | 3 | .12 | 0 |
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus
-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Der Standardwert ist dependent on the locale and operating system..
Implementierung
public function get trailingZeros():Boolean
public function set trailingZeros(value:Boolean):void
Auslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
useGrouping | Eigenschaft |
useGrouping:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Aktiviert die Verwendung des Gruppierungstrennzeichens bei der Formatierung von Zahlen.
Wenn die useGrouping
-Eigenschaft den Wert true
hat, werden Ziffern gruppiert und durch ein Gruppierungstrennzeichen getrennt. Beispiel: 123,456,789.22
Wenn die useGrouping
-Eigenschaft den Wert false
hat, werden die Ziffern nicht gruppiert oder getrennt. Beispiel: 123456789.22
Das Symbol, das als Gruppierungstrennzeichen verwendet wird, wird mit der groupingSeparator
-Eigenschaft definiert. Die Anzahl der Ziffern zwischen den Gruppierungstrennzeichen wird mit der groupingPattern
-Eigenschaft definiert.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus
-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Implementierung
public function get useGrouping():Boolean
public function set useGrouping(value:Boolean):void
Verwandte API-Elemente
NumberFormatter | () | Konstruktor |
public function NumberFormatter(requestedLocaleIDName:String)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Konstruiert ein neues NumberFormatter-Objekt, um Zahlen entsprechend den Konventionen eines gegebenen Gebietsschemas zu formatieren.
Dieser Konstruktor ermittelt, ob das aktuelle Betriebssystem den angeforderten Gebietsschema-ID-Namen unterstützt. Wenn dieser nicht unterstützt wird, wird stattdessen ein Ersatzgebietsschema verwendet. Wenn ein Ersatzgebietsschema verwendet wird, gibt die lastOperationStatus
-Eigenschaft den Typ der Ausweichlösung an und die actualLocaleIDName
-Eigenschaft enthält den Namen der Ersatzgebietsschema-ID.
Für die Formatierung anhand der Einstellungen des aktuellen Betriebssystems des Benutzers, übergeben Sie den Wert LocaleID.DEFAULT
im requestedLocaleIDName
-Parameter an den Konstruktor.
Wenn der Konstruktor erfolgreich abgeschlossen wird, wird die lastOperationStatus
-Eigenschaft auf diesen Wert gesetzt:
LastOperationStatus.NO_ERROR
Wenn der angeforderte Gebietsschema-ID-Name nicht verfügbar ist, hat lastOperationStatus
einen der folgenden Werte:
LastOperationStatus.USING_FALLBACK_WARNING
LastOperationStatus.USING_DEFAULT_WARNING
Wenn diese Klasse vom aktuellen Betriebssystem nicht unterstützt wird, hat die lastOperationStatus
-Eigenschaft den folgenden Wert:
LastOperationStatus.UNSUPPORTED_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Details zu den oben aufgeführten Warnungen und zu anderen möglichen Werten der lastOperationStatus
-Eigenschaft finden Sie im Abschnitt zur LastOperationStatus
-Klasse.
requestedLocaleIDName:String — Der bevorzugte Gebietsschema-ID-Name, der beim Bestimmen von Zahlenformaten verwendet wird.
|
Auslöser
TypeError — wenn requestedLocaleIDName den Wert null hat
|
Verwandte API-Elemente
formatInt | () | Methode |
public function formatInt(value:int):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Formatiert einen int-Wert. Diese Funktion entspricht der formatNumber()
-Methode, verwendet jedoch einen int
-Wert. Wenn der übergebene Wert zu groß oder zu klein ist, zum Beispiel ein Wert größer als 1.72e308 oder kleiner als 1.72e-308, gibt diese Funktion 0 zurück.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus
-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Parameter
value:int — Ein int-Wert, der formatiert werden soll.
|
String — Ein formatierter Zahlenstring.
|
Auslöser
MemoryError — für alle internen Speicherzuordnungsprobleme.
|
Verwandte API-Elemente
formatNumber | () | Methode |
public function formatNumber(value:Number):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Formatiert einen Number-Wert.
Diese Funktion formatiert die Zahl anhand der Eigenschaftenwerte des Formatters. Wenn die Eigenschaften nach dem Erstellen des numberFormatter-Objekts nicht geändert werden, werden die Zahlen so formatiert, wie es die gebietsschemaspezifischen Konventionen vorsehen, die vom Betriebssystem für das mit actualLocaleIDName angegebene Gebietsschema bereitgestellt werden. Zur Anpassung des Formats können die Eigenschaften geändert werden, um bestimmte Aspekte der Zahlenformatierung zu steuern.
Mit dieser Funktion können sehr große und sehr kleine Zahlen formatiert werden. Die Anzahl der bedeutenden Ziffern wird jedoch durch die vom Number-Objekt angegebene Genauigkeit limitiert. Die wissenschaftliche Schreibweise wird nicht unterstützt.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus
-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Parameter
value:Number — Ein Number-Wert, der formatiert werden soll.
|
String — Ein formatierter Zahlenstring.
|
Auslöser
MemoryError — falls es interne Speicherzuordnungsprobleme gibt.
|
Verwandte API-Elemente
formatUint | () | Methode |
public function formatUint(value:uint):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Formatiert einen uint-Wert. Diese Funktion entspricht der formatNumber()
-Methode, verwendet jedoch einen uint
-Wert. Wenn der übergebene Wert zu groß ist, zum Beispiel ein Wert größer als 1.72e308, gibt diese Funktion 0 zurück.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus
-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Parameter
value:uint — Ein uint-Wert.
|
String — Ein formatierter Zahlenstring.
|
Auslöser
MemoryError — falls es interne Speicherzuordnungsprobleme gibt.
|
Verwandte API-Elemente
getAvailableLocaleIDNames | () | Methode |
public static function getAvailableLocaleIDNames():Vector.<String>
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden.
Wenn diese Klasse vom aktuellen Betriebssystem nicht unterstützt wird, gibt diese Methode einen Null-Wert zurück.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus
-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Vector.<String> — Ein Vektor von Strings, der alle von dieser Klasse unterstützten Gebietsschema-ID-Namen enthält.
|
parse | () | Methode |
public function parse(parseString:String):NumberParseResult
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Analysiert einen String und gibt ein NumberParseResult-Objekt zurück, das die analysierten Elemente enthält.
Das NumberParseResult-Objekt enthält den Wert der ersten Zahl, die im Eingabestring gefunden wird, den Startindex für die Zahl in diesem String und den Index des ersten Zeichens nach der Zahl im String.
Wenn der String keine Zahl enthält, wird die value-Eigenschaft von NumberParseResult auf NaN
gesetzt und die Eigenschaften startIndex
und endIndex
werden auf den Hexadezimalwert 0x7fffffff
gesetzt.
Diese Funktion verwendet den Wert der decimalSeparator
-Eigenschaft, um den Teil der Zahl zu ermitteln, der gebrochene Ziffern enthält, die groupingSeparator
-Eigenschaft, um zu ermitteln, welche Zeichen in den Ziffern einer Zahl zulässig sind, und die negativeNumberFormat
-Eigenschaft, um zu steuern, wie negative Werte dargestellt werden.
In der folgenden Tabelle sind die Ergebnisse von analysierten Strings für die verschiedenen Werte von NegativeNumberFormat aufgeführt:
NegativeNumberFormat | Input String | Ergebnis |
(n) | "(123)" oder "( 123 )" | "-123" |
-n | "-123" oder "- 123" | "-123" |
- n | "-123" oder "- 123" | "-123" |
n- | "123-" oder "123 -" | "-123" |
n - | "123-" oder "123 -" | "-123" |
Zwischen den Zahlen und dem Minuszeichen oder den Klammern ist ein einzelner Leerraum zulässig.
Andere Eigenschaften werden beim Ermitteln einer gültigen Nummer ignoriert. Speziell der Wert der digitsType
-Eigenschaft wird ignoriert und die Ziffern können aus einem der Ziffernsätze stammen, die in der NationalDigitsType-Klasse aufgezählt werden. Die Werte der Eigenschaften groupingPattern
und useGrouping
haben keinen Einfluss auf die Analyse der Zahl.
Wenn vor oder hinter einer Zahl im String ein Pluszeichen + steht, wird das Pluszeichen als Zeichen gewertet, das kein Teil der Zahl ist.
Diese Funktion analysiert keine Strings, die Zahlen in wissenschaftlicher Schreibweise enthalten (z. B. 1.23e40).
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus
-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Parameter
parseString:String |
NumberParseResult |
Auslöser
TypeError — wenn der parseString den Wert null hat
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
var nf:NumberFormatter = new NumberFormatter("fr-FR"); var str:String = "1,56 mètre" var result:NumberParseResult = nf.parse(str); trace(result.value) // 1.56 trace(str.substr(0,result.startIndex)); // "" trace(str.substr(result.startIndex, result.endIndex)); // "1,56" trace(str.substr(result.endIndex)); // " mètre"
parseNumber | () | Methode |
public function parseNumber(parseString:String):Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Analysiert einen String, der nur Ziffern und optionale Leerraumzeichen enthält und gibt eine Zahl zurück. Wenn der String nicht mit einer Zahl beginnt oder andere Zeichen als Leerraum enthält, die nicht Teil der Zahl sind, gibt diese Methode NaN
zurück. Leerraum vor oder nach den numerischen Zeichen wird ignoriert. Ein Leerraumzeichen ist ein Zeichen, das eine Space Separator (Zs)-Eigenschaft in der Unicode-Zeichendatenbank hat (siehe http://www.unicode.org/ucd/).
Wenn vor oder hinter der numerischen Ziffer ein Pluszeichen „+“ steht, wird es als Nicht-Leerraumzeichen behandelt. Der Rückgabewert ist NaN
.
Weitere Informationen zur Analyse von Zahlen und der Definition von gültigen Zahlen finden Sie in der Beschreibung der parse-Funktion.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus
-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Parameter
parseString:String |
Number |
Auslöser
TypeError — wenn der parseString den Wert null hat
|
Verwandte API-Elemente
Dieses Beispiel verwendet die folgenden Gebietsschemas: Standardgebietsschema des Betriebssystems für die Zahlenformatierung, Japanisch (Japan), Englisch (USA) und Französisch (Frankreich). Das Beispiel verwendet das statische Mitglied LocaleID.DEFAULT
, um das Standardgebietsschema des Betriebssystem abzufragen.
Die Ergebnisse aus diesem Beispiel können in Abhängigkeit von Ihrem Betriebssystem und den Benutzereinstellungen variieren.
Dieses Beispiel führt für jedes Gebietsschema in der Liste Folgendes aus:
- Erstellt ein NumberFormatter-Objekt.
- Formatiert denselben Wert als Number, als Ganzzahl und als vorzeichenlose Ganzzahl und zeigt die Ergebnisse an.
package { import flash.globalization.NumberFormatter; import flash.globalization.LocaleID; public class NumberFormatterExample extends Sprite { public function NumberFormatterExample():void { var localeNames:Array = [LocaleID.DEFAULT,"ja_JP","en_US","fr_FR"]; for ( var i:int = 0; i < localeNames.length; i++ ) { var nf:NumberFormatter = new NumberFormatter( localeNames[i] as String ); trace('\n\n' + "LocaleID requested: " + nf.requestedLocaleIDName + "; actual: " + nf.actualLocaleIDName); trace( "Last Operation Status:" + nf.lastOperationStatus ); var numberString:String = nf.formatNumber(123456789.19); trace( "Formatted Number:" + numberString); numberString = nf.formatInt(-123456789); trace( "Formatted Int:" + numberString); numberString = nf.formatUint(123456789); trace( "Formatted UInt:" + numberString); } } } }
Die Ergebnisse aus diesem Beispiel können in Abhängigkeit von Ihrem Betriebssystem und den Benutzereinstellungen variieren.
Dieses Beispiel führt Folgendes aus:
- Erstellt ein NumberFormatter-Objekt.
- Ruft die
NumberFormatter.parse()
-Methode auf, um den String zu analysieren, und gibt ein NumberParseResult-Objekt zurück. - Ruft die
NumberFormatter.parseNumber()
-Methode auf, um den String zu analysieren, und gibt einen Number-Wert zurück.
package { import flash.globalization.NumberFormatter; import flash.globalization.NumberParseResult; import flash.globalization.LastOperationStatus; import flash.globalization.LocaleID; public class NumberFormatterParseExample { public function NumberFormatterParseExample():void { var nf:NumberFormatter = new NumberFormatter( "en_US" ); trace("LocaleID requested: " + nf.requestedLocaleIDName + "; actual: " + nf.actualLocaleIDName); trace( "Last Operation Status:" + nf.lastOperationStatus ); var inputNumberString:String = "123,567,89,0.254"; var parseResult:NumberParseResult = nf.parse(inputNumberString); if ( nf.lastOperationStatus == LastOperationStatus.NO_ERROR ) { trace("Parsed value:" + parseResult.value); } inputNumberString = "-123,567,89,0.254"; var parsedNumber:Number = nf.parseNumber(inputNumberString); if ( nf.lastOperationStatus == LastOperationStatus.NO_ERROR ) { trace("Parsed value:" + parsedNumber); } } } }
Tue Jun 12 2018, 10:04 AM Z