ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.globalization 

NumberFormatter  - AS3

Paketflash.globalization
Klassepublic final class NumberFormatter
VererbungNumberFormatter Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2

Die NumberFormatter-Klasse stellt gebietsschemabeachtende Formatierung und Analyse von numerischen Werten bereit. Sie kann 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.

Beispiele anzeigen



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  actualLocaleIDName : String
[schreibgeschützt] Der Name der Gebietsschema-ID, die von diesem NumberFormatter-Objekt verwendet wird.
NumberFormatter
 Inheritedconstructor : 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
Öffentliche Methoden
 MethodeDefiniert 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
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
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
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

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.

  1. Wenn das angeforderte Gebietsschema nicht LocaleID.DEFAULT war und das Betriebssystem das angeforderten Gebietsschema unterstützt, ist der zurückgegebene Name identisch mit der requestedLocaleIDName-Eigenschaft.
  2. Wenn LocaleID.DEFAULT als Wert für den requestedLocaleIDName-Parameter an den Konstruktor übergeben wurde, wird der Name des aktuellen Gebietsschemas verwendet, der vom Betriebssystem des Benutzers angegeben wird. Der LocaleID.DEFAULT-Wert bewahrt die benutzerdefinierten Einstellungen im Betriebssystem. Mit der Übergabe eines expliziten Werts als requestedLocaleIDName-Parameter wird nicht unbedingt dasselbe Ergebnis erzielt wie mit der Verwendung von LocaleID.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, anstatt LocaleID.DEFAULT zu verwenden, ruft Ihre Anwendung diese benutzerdefinierten Einstellungen nicht ab.
  3. 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.

GruppierungsmusterBeispielformat
3;*123,456,789.12
3;2;*12,34,56,789.12
3123456,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.

trailingZerosleadingZerofractionalDigits0.120
truetrue30.1200.000
falsetrue30.120
truefalse3.120.000
falsefalse3.120

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 ZahlenFormat
0(n)
1-n
2- n
3n-
4n -

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.

trailingZerosleadingZerofractionalDigits0.120
truetrue30.1200.000
falsetrue30.120
truefalse3.120.000
falsefalse3.120

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

Konstruktordetails

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.

Parameter
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

Methodendetails

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.

Rückgabewerte
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.

Rückgabewerte
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.

Rückgabewerte
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.

Rückgabewerte
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:

NegativeNumberFormatInput StringErgebnis
(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

Rückgabewerte
NumberParseResult

Auslöser
TypeError — wenn der parseString den Wert null hat

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Der folgende Code analysiert eine Zahl aus einem String und ruft das Präfix und das Suffix ab:
 
         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

Rückgabewerte
Number

Auslöser
TypeError — wenn der parseString den Wert null hat

Verwandte API-Elemente

NumberFormatterExample.as

Dieses Beispiel zeigt die unterschiedliche Formatierung von Zahlen in verschiedenen Gebietsschemas.

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:

  1. Erstellt ein NumberFormatter-Objekt.
  2. 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);
            }
        }
    }
}
NumberFormatterParseExample.as

Dieses Beispiel zeigt zwei verschiedene Möglichkeiten, einen Eingabestring zu analysieren und einen numerischen Wert zu extrahieren.

Die Ergebnisse aus diesem Beispiel können in Abhängigkeit von Ihrem Betriebssystem und den Benutzereinstellungen variieren.

Dieses Beispiel führt Folgendes aus:

  1. Erstellt ein NumberFormatter-Objekt.
  2. Ruft die NumberFormatter.parse()-Methode auf, um den String zu analysieren, und gibt ein NumberParseResult-Objekt zurück.
  3. 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);
                }
            }
      }
}




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.