Es gibt zwei Möglichkeiten, ein Datum- und Uhrzeitformat auszuwählen: mithilfe eines vordefinierten Musters oder mithilfe eines benutzerdefinierten Musters. Für die meisten Anwendungen sollten die von den DateTimeStyle-Konstanten vordefinierten Stile (
Der folgende Code erstellt zum Beispiel einen Datumsstring unter Verwendung des kurzen Standarddatumsformat:
Wenn eine Instanz dieser Klasse erstellt wird und das angeforderte Gebietsschema vom Betriebssystem unterstützt wird, werden die Eigenschaften der Instanz gemäß den Konventionen und Standards des angeforderten Gebietsschemas und der
Diese Klasse enthält zusätzliche Methoden, um lokalisierte Strings für Monatsnamen und Wochentagsnamen sowie den ersten Tag der Woche abzurufen, der in einer Kalenderauswahl oder ähnlichen Anwendungen verwendet werden kann.
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.
In diesem Beispiel werden die folgenden Gebietsschemas verwendet: Englisch (USA), Französisch (Frankreich), Spanisch (Spanien).
Das Beispiel führt für jedes Gebietsschema in der Liste Folgendes aus:
Das Beispiel führt für jedes Gebietsschema in der Liste Folgendes aus:
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. Der Name der Ersatzgebietsschema-ID kann anhand der
Wenn ein Ersatz für einen der Parameter
Für die Formatierung anhand der Einstellungen des aktuellen Betriebssystems des Benutzers, übergeben Sie den Wert
Wenn der Konstruktor aufgerufen und erfolgreich abgeschlossen wird, wird die
Wenn der angeforderte Gebietsschema-ID-Name nicht verfügbar ist, hat
Andernfalls wird die
Details zu den oben aufgeführten Warnungen und zu anderen möglichen Werten der
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
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
Andernfalls wird die
Mögliche Werte:
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Dieses kann auf drei Arten festgelegt werden:
Eine Beschreibung der Syntax finden Sie im Abschnitt zur
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Mögliche Werte:
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Das Muster für die Formatierung von Datumsangaben kann auf drei Arten festgelegt werden:
Als Nebeneffekt dieser Methode werden die aktuellen Uhrzeit- und Datumsstile für dieses DateTimeFormatter-Objekt überschrieben und auf den Wert
Ein Musterstring definiert, wie Datum und Uhrzeit formatiert werden. Das Muster enthält Buchstabenfolgen, die im formatierten String durch Datums- und Uhrzeitwerte ersetzt werden. Im Muster „yyyy/MM“ werden die Buchstaben „yyyy“ durch die vierstellige Jahreszahl ersetzt, danach folgt ein Schrägstrich („/“) und die Buchstaben „MM“ werden durch die zweistelligen Monatsangabe ersetzt.
Viele der in Mustern verwendeten Buchstaben können mehrmals wiederholt werden, um verschiedene Ausgaben zu produzieren, wie nachstehend beschrieben.
Wenn eine Buchstabenfolge die maximal zulässige Anzahl von Buchstaben, die im Muster unterstützt werden, überschreitet, wird sie der längsten unterstützten Folge für diesen Musterbuchstaben zugeordnet. Beispiel:
Theoretisch kann ein Muster bis zu 255 Zeichen enthalten, bei einigen Plattformen gelten jedoch andere Beschränkungen. Wenn das Muster die zulässige Anzahl von Zeichen überschreitet, wird die
Nicht alle möglichen Muster werden von jedem Betriebssystem unterstützt. Wenn ein Muster von der Plattform nicht unterstützt wird, wird ein Ersatzmuster verwendet und die
In der folgenden Tabelle sind die gültigen Musterbuchstaben und ihre Bedeutung aufgeführt.
Ein Äramuster kann einen bis fünf Buchstaben enthalten, die folgendermaßen interpretiert werden:
Beispiele mit dem Gregorianischen Kalender (für Betriebssysteme, die dieses Muster unterstützen):
Beispiele:
Beispiele:
Beispiele:
Beispiele:
Beispiele (für Betriebssysteme, die dieses Muster unterstützen):
Beispiele für die zweite Woche des Jahres (bei Betriebssystemen, die dieses Muster unterstützen):
Beispiele für die zweite Woche des Monats Juli (bei Betriebssystemen, die dieses Muster unterstützen):
Beispiele für den zweiten Tag des Jahres (bei Betriebssystemen, die dieses Muster unterstützen):
Beispiele für den zweiten Mittwoch im Juli (bei Betriebssystemen, die dieses Muster unterstützen):
Beispiele:
Beispiele:
Beispiele:
Beispiele (für Betriebssysteme, die dieses Muster unterstützen):
Beispiele (für Betriebssysteme, die dieses Muster unterstützen):
Beispiele:
Beispiele:
Beispiele:
Dieses Zeitzonenmuster muss einen bis vier Buchstaben enthalten, die folgendermaßen interpretiert werden:
Beispiele für Betriebssysteme, die dieses Format unterstützen:
Dieses Zeitzonenmuster muss einen bis vier Buchstaben enthalten, die folgendermaßen interpretiert werden:
Beispiele für Betriebssysteme, die dieses Format unterstützen:
Dieses Zeitzonenmuster muss einen oder vier Buchstaben enthalten, die folgendermaßen interpretiert werden:
Beispiele für Betriebssysteme, die dieses Format unterstützen:
Beispiele:
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Es drei Möglichkeiten für den Wert des Namens, abhängig vom Betriebssystem und dem Wert des
Beispiel:
var fmt:DateTimeFormatter = new DateTimeFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; Im obigen Beispiel ist
aliName der Name des Gebietsschemas, das den aktuellen Einstellungen im Betriebssystem des Benutzers entspricht (z. B. „it-IT“, wenn das Gebietsschema des Benutzers auf Italienisch-Italien eingestellt ist), und nicht"i-default" (der Name desLocaleID.DEFAULT -Gebietsschemas).
Zum Beispiel:
var fmt:DateTimeFormatter = new DateTimeFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName; Wenn das im obigen Beispiel verwendete Betriebssystem die Gebietsschema-ID „fr-CA“ (Französisch-Kanada) nicht unterstützt, wird eine Ausweichlösung verwendet. In diesem Fall ist die Ersatzgebietsschema-ID „fr-FR“ (Französisch-Frankreich).
Wenn der Wert
Der folgende Code zeigt zum Beispiel, dass ein Fehlerstatus „ungültiges Argument“ festgelegt wird, wenn die
Das folgende Beispiel zeigt, dass das Festlegen der
Der folgende Code zeigt zum Beispiel den Wert der
Der folgende Code zeigt zum Beispiel den Wert der
Der Zahlenstring kann ein Präfix und ein Suffix enthalten, das vor bzw. hinter einer Zahl steht. In diesen Fällen wird die
In diesem Beispiel werden die folgenden Gebietsschemas verwendet: Arabisch (Saudi-Arabien), Englisch (USA), Englisch (USA, POSIX-Variante), Chinesisch (VR China), Chinesisch (Taiwan), Chinesisch (Vereinfachte Han-Schriftzeichen), Chinesisch (VR China mit verschiedenen Tasten und Werten).
Das Beispiel führt für jedes Gebietsschema in der Liste Folgendes aus:
Wenn der Konstruktor erfolgreich abgeschlossen wird, wird die
Wenn der angeforderte Gebietsschema-ID-Name nicht verfügbar ist, hat
Andernfalls wird die
Details zu den oben aufgeführten Warnungen und zu anderen möglichen Werten der
Die resultierende Liste ist nach Präferenz geordnet.
Dies ist ein typischer Einsatz dieser Methode:
Wenn diese Funktion 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
Andernfalls wird die
Das zurückgegebene Objekt ist als Hash-Tabelle oder assoziatives Array strukturiert, wobei jeder Eigenschaftenname einen Schlüssel und der Wert der Eigenschaft den Wert repräsentiert. Mit dem folgenden Code werden zum Beispiel alle Schlüssel und Werte aufgeführt, die mit der
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Wenn der Name des Gebietsschemas nicht korrekt analysiert werden kann, ist der Sprachcode mit dem vollständigen Gebietsschemanamen identisch.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Diese Methode gibt einen leeren String zurück, wenn der Regionscode nicht analysiert oder „erraten“ werden kann. Dies kann vorkommen, wenn ein unbekannter oder ein unvollständiger Gebietsschema-ID-Name wie „xy“ verwendet wird. Der Regionscode wird nicht anhand einer festen Liste validiert. Zum Beispiel wird für den Gebietsschema-ID-Namen „xx-YY“ der Regionscode „YY“ zurückgegeben.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Wenn die Region nicht Teil des angegebenen Gebietsschemanamens ist, wird der wahrscheinlichste Regionscode für das Gebietsschema „geraten“ und die
Andernfalls wird die
Diese Methode gibt einen leeren String zurück, wenn der Skriptcode nicht analysiert oder „erraten“ werden kann. Dies kann vorkommen, wenn ein unbekannter oder ein unvollständiger Gebietsschema-ID-Name wie „xy“ verwendet wird. Der Skriptcode wird nicht anhand einer festen Liste validiert. Zum Beispiel wird für den Gebietsschema-ID-Namen „xx-Abcd-YY“ der Skriptcode „Abcd“ zurückgegeben.
Die Region kann wie die Sprache den Rückgabewert beeinflussen. Der Skriptcode für „mn-MN“ (Mongolisch-Mongolei) ist zum Beispiel „Cyrl“ (Kyrillisch), während der Skriptcode für „mn-CN“ (Mongolisch-China) „Mong“ (Mongolisch) lautet.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Wenn der Skriptcode nicht Teil des angegebenen Gebietsschemanamens ist, wird der wahrscheinlichste Skriptcode für das Gebietsschema „geraten“ und die
Andernfalls wird die
Diese Methode gibt einen leeren String zurück, wenn der angegebene Gebietsschema-ID-Name keinen Sprachvariantencode enthält. (Es muss nicht geraten werden, da nur wenige Gebietsschemas eine Sprachvariante haben oder benötigen.)
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Mit dem Ergebnis kann die Textrichtung in der Flash-Text-Engine bestimmt und entschieden werden, ob die Benutzeroberfläche gespiegelt werden sollte, um die aktuelle Textrichtung zu unterstützen.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Die Verwendung der
Dieser Gebietsschemabezeichner ist nicht immer der am besten geeignete. Bei Anwendungen, die im Browser ausgeführt werden, könnte das im Browser bevorzugte Gebietsschema die bessere Wahl sein. Häufig empfiehlt es sich, dem Benutzer die Möglichkeit zu geben, die Einstellung für den bevorzugten Gebietsschema-ID-Namen zu ändern und diese Einstellung in einem Benutzerprofil, einem Cookie oder einem gemeinsam genutzten Objekt zu speichern.
Diese Methode führt die folgenden Konvertierungen am Namen der Gebietsschema-ID aus, um ihn eine kanonischere Form zu geben:
Es wird keine weitere Verarbeitung ausgeführt. So werden Aliasnamen zum Beispiel nicht ersetzt und es werden keine Elemente hinzugefügt oder entfernt.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Die
In einigen Situationen ist die Konvertierung von Groß- und Kleinbuchstaben nicht ein einfaches Zuordnen von einem Zeichen zu einem anderen, sondern benötigt sprachen- oder kontextabhängige Verarbeitung. Beispiel:
Die Methoden
Aufgrund der Verwendung von Benutzereinstellungen, von Regeln für die Umwandlung von Groß- und Kleinbuchstaben, die vom Betriebssystem bereitgestellt werden, und von einem Ersatzgebietsschema, falls das angeforderte Gebietsschema nicht unterstützt wird, sehen die Benutzer möglicherweise unterschiedliche Groß-/Kleinbuchstabenkonvertierungen, selbst wenn sie dasselbe Gebietsschema verwenden.
Dieses Beispiel führt die folgenden Schritte aus:
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
Wenn dieser Konstruktor erfolgreich abgeschlossen wird, wird die
Wenn der angeforderte Gebietsschema-ID-Name nicht verfügbar ist, hat
Andernfalls wird die
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
Andernfalls wird die
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Es gibt drei Möglichkeiten für den Wert des Namens, abhängig vom Betriebssystem und dem Wert des
Beispiel:
var tools:StringTools = new StringTools(LocaleID.DEFAULT); var aliName:String = tools.actualLocaleIDName; Im obigen Beispiel ist
aliName der Name des Gebietsschemas, das den aktuellen Einstellungen im Betriebssystem des Benutzers entspricht (z. B. „it-IT“, wenn das Gebietsschema des Benutzers auf Italienisch-Italien eingestellt ist), und nicht"i-default" (der Name desLocaleID.DEFAULT -Gebietsschemas).
Zum Beispiel:
var tools:StringTools = new StringTools("fr-CA"); var aliName:String = tools.actualLocaleIDName; Wenn das im obigen Beispiel verwendete Betriebssystem die Gebietsschema-ID „fr-CA“ (Französisch-Kanada) nicht unterstützt, wird eine Ausweichlösung verwendet. In diesem Fall ist die Ersatzgebietsschema-ID „fr-FR“ (Französisch-Frankreich).
Wenn der Wert
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
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.
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
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:
Die Ergebnisse aus diesem Beispiel können in Abhängigkeit von Ihrem Betriebssystem und den Benutzereinstellungen variieren.
Dieses Beispiel führt Folgendes aus:
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
Für die Formatierung anhand der Einstellungen des aktuellen Betriebssystems des Benutzers, übergeben Sie den Wert
Wenn der Konstruktor erfolgreich abgeschlossen wird, wird die
Wenn der angeforderte Gebietsschema-ID-Name nicht verfügbar ist, hat
Wenn diese Klasse vom aktuellen Betriebssystem nicht unterstützt wird, hat die
Andernfalls wird die
Details zu den oben aufgeführten Warnungen und zu anderen möglichen Werten der
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
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
Andernfalls wird die
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
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
Andernfalls wird die
Wenn vor oder hinter der numerischen Ziffer ein Pluszeichen „+“ steht, wird es als Nicht-Leerraumzeichen behandelt. Der Rückgabewert ist
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
Andernfalls wird die
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
Diese Funktion verwendet den Wert der
In der folgenden Tabelle sind die Ergebnisse von analysierten Strings für die verschiedenen Werte von NegativeNumberFormat aufgeführt:
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
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
Andernfalls wird die
Es drei Möglichkeiten für den Wert des Namens, abhängig vom Betriebssystem und dem Wert des
Beispiel:
var fmt:NumberFormatter = new NumberFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; Im obigen Beispiel ist
aliName der Name des Gebietsschemas, das den aktuellen Einstellungen im Betriebssystem des Benutzers entspricht (z. B. „it-IT“, wenn das Gebietsschema des Benutzers auf Italienisch-Italien eingestellt ist), und nicht"i-default" (der Name desLocaleID.DEFAULT -Gebietsschemas).
Zum Beispiel:
var fmt:NumberFormatter = new NumberFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName; Wenn das im obigen Beispiel verwendete Betriebssystem die Gebietsschema-ID „fr-CA“ (Französisch-Kanada) nicht unterstützt, wird eine Ausweichlösung verwendet. In diesem Fall ist die Ersatzgebietsschema-ID „fr-FR“ (Französisch-Frankreich).
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
Andernfalls wird die
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
Andernfalls wird die
Zahlen werden auf die Anzahl von Ziffern gerundet, die mit dieser Eigenschaft angegeben wird. Das Rundungsschema variiert je nach Betriebssystem des Benutzers.
Wenn die
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Wenn die
Das Gruppierungsmuster wird als String definiert, der Zahlen enthält, die durch Kommas getrennt sind, und der optional mit einem Asterisk enden kann. Beispiel:
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:
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.
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
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Der Wert dieser Eigenschaft wird beim Formatieren von Zahlen mit der
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Wenn diese Eigenschaft auf
Wenn die Zahl zum Beispiel 0.321 lautet und diese Eigenschaft den Wert
Die folgende Tabelle enthält Beispiele für die Formatierung von Zahlen anhand der Werte für diese Eigenschaft und die verwandten Eigenschaften
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
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
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
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
Andernfalls wird die
Wenn der Wert
Wenn diese Eigenschaft den Wert
Lautet der numerische Wert beispielsweise 123.4 und diese Eigenschaft hat den Wert „true“, während die
Die folgende Tabelle enthält Beispiele für die Formatierung von numerischen Werten anhand der Werte für diese Eigenschaft und die verwandten Eigenschaften
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Wenn die
Wenn die
Das Symbol, das als Gruppierungstrennzeichen verwendet wird, wird mit der
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Der context-Parameter ändert die Ergebnisse dieser Methoden nur für bestimmte Gebietsschemas und Betriebssysteme. Bei den meisten Gebietsschemas unterscheidet sich die Liste der Namen für die Monate und Wochentage nicht durch den Kontext.
Die CurrencyFormatter-Klasse verwendet die Daten und Funktionen, die vom Betriebssystem bereitgestellt werden, und wurde entwickelt, um Währungswerte entsprechend den Konventionen eines bestimmten Gebietsschemas und dem Währungstyp zu formatieren. Die Position des Währungssymbols, das Negativsymbol, das Dezimalzeichen, das Gruppierungstrennzeichen, das Gruppierungsmuster und andere Elemente variieren je nach Gebietsschema.
Wenn das Betriebssystem das angeforderte Gebietsschema unterstützt, werden die Eigenschaften und der Währungstyp 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
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.
Dieses Beispiel verwendet die folgenden Gebietsschemas:
Das Beispiel führt für jedes Gebietsschema in der Liste Folgendes aus:
Dieses Beispiel führt die folgenden Schritte aus:
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
Bestimmte Eigenschaften, zum Beispiel
HINWEIS: Wenn ein Ersatzgebietsschema verwendet wird, werden die Währungseigenschaften auf die Standardwerte gesetzt, weshalb die Eigenschaften
Für die Formatierung anhand der Einstellungen des aktuellen Betriebssystems des Benutzers, übergeben Sie den Wert
Wenn der Konstruktor aufgerufen und erfolgreich abgeschlossen wird, wird die
Wenn der angeforderte Gebietsschema-ID-Name nicht verfügbar ist, hat
Andernfalls wird die
Details zu den oben aufgeführten Warnungen und zu anderen möglichen Werten der
Standardmäßig verwendet diese Methode die
Viele Länder und Regionen verwenden dieselben Währungssymbole für verschiedene Währungen. Die Vereinigten Staaten, Australien, Neuseeland, Kanada und Mexiko verwenden zum Beispiel alle dasselbe Dollarzeichen ($) für lokale Währungswerte. Wenn sich die formatierte Währung von der lokalen Währung des Benutzers unterscheidet, ist es am besten, den ISO-Code als Währungsstring zu verwenden. Mit der
Diese Methode kann sehr große und sehr kleine Zahlen formatieren. Die Anzahl der bedeutenden Ziffern wird jedoch durch die vom Number-Datentyp angegebene Genauigkeit limitiert.
Das zweite Beispiel zeigt eine Methode, mit der ein Währungsbetrag in kanadischen Dollar unter Verwendung des Standardgebietsschemas des Benutzers formatiert wird. Mit der
In vielen Regionen und Ländern werden dieselben Währungssymbole verwendet. Mit dieser Methode lässt sich verhindern, dass ein mehrdeutiges Währungssymbol verwendet wird, oder Währungssymbole oder ISO-Codes, die wegen der Verwendung eines Ersatzgebietsschemas nicht den erwarteten entsprechen.
Diese Methode wird häufig eingesetzt, um zu bestimmen, ob ein lokales Währungssymbol angezeigt werden soll (wenn der Betrag in der Standardwährung des Benutzers formatiert wird) oder ein genauerer ISO-Code (wenn der Betrag in einer Währung formatiert wird, die nicht dem Standard des Benutzers entspricht).
Die Methode vergleicht den
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
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
Andernfalls wird die
Der Analysealgorithmus verwendet den Wert der
Wenn die Reihenfolge des Währungssymbols, des Minuszeichens und der Zahl im Eingabestring nicht mit dem von den Eigenschaften
Der Eingabestring kann Leerzeichen enthalten; diese werden bei der Analyse ignoriert.
Die Analyse kann erfolgreich sein, auch wenn kein Währungssymbol vorhanden ist. Der Teil des Strings, der dem Währungssymbol entspricht, wird nicht validiert. Wenn es kein Währungssymbol bzw. keinen Währungsstring gibt, wird die
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls werden die
Es drei Möglichkeiten für den Wert des Namens, abhängig vom Betriebssystem und dem Wert des
Beispiel:
var fmt:CurrencyFormatter = new CurrencyFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; Im obigen Beispiel ist
aliName der Name des Gebietsschemas, das den aktuellen Einstellungen im Betriebssystem des Benutzers entspricht (zum Beispiel „it-IT“, wenn das Gebietsschema des Benutzers auf Italienisch-Italien eingestellt ist), und nicht"i-default" (der Name desLocaleID.DEFAULT -Gebietsschemas).
Zum Beispiel:
var fmt:CurrencyFormatter = new CurrencyFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName; Wenn das im obigen Beispiel verwendete Betriebssystem die Gebietsschema-ID „fr-CA“ (Französisch-Kanada) nicht unterstützt, wird eine Ausweichlösung verwendet. In diesem Fall ist die Ersatzgebietsschema-ID „fr-FR“ (Französisch-Frankreich).
Mit diesem Code wird das Währungssymbol oder der Währungsstring ermittelt, wenn Währungsbeträge mit der
Diese Eigenschaft wird vom Konstruktor initialisiert, basierend auf dem tatsächlich verwendeten Gebietsschema. Wenn ein Ersatzgebietsschema verwendet wird, gibt diese Eigenschaft den bevorzugten Standardwährungscode für das Ersatzgebietsschema an.
Diese Eigenschaft wird als Währungssymbol verwendet, wenn Währungsbeträge mit der
Diese Eigenschaft wird vom Konstruktor initialisiert, basierend auf dem tatsächlich verwendeten Gebietsschema. Wenn ein Ersatzgebietsschema verwendet wird, gibt diese Eigenschaft das bevorzugte Standardwährungssymbol für das Ersatzgebietsschema an.
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
Andernfalls wird die
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
Andernfalls wird die
Zahlen werden auf die Anzahl von Ziffern gerundet, die mit dieser Eigenschaft angegeben wird. Das Rundungsschema variiert je nach Betriebssystem des Benutzers.
Wenn die
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Wenn die
Das Gruppierungsmuster wird als String definiert, der Zahlen enthält, die durch Kommas getrennt sind, und der optional mit einem Asterisk enden kann. Beispiel:
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:
In der folgenden Tabelle sind Beispiele für die Formatierung des Währungsbetrags 123456789.12 mit verschiedenen Gruppierungsmustern aufgeführt. Das Gruppierungstrennzeichen ist ein Komma, das Dezimalzeichen ist ein Punkt und das Währungssymbol ist das Dollarzeichen ($).
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
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Der Wert dieser Eigenschaft wird beim Formatieren von Währungsbeträgen als Gruppierungstrennzeichen verwendet, wenn die
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Wenn diese Eigenschaft auf
Wenn der Währungsbetrag zum Beispiel 0.321 lautet und diese Eigenschaft den Wert
Die folgende Tabelle enthält Beispiele für die Formatierung von Währungsbeträgen anhand der Werte für diese Eigenschaft und die verwandten Eigenschaften
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Der Wert dieser Eigenschaft muss eine der in der folgenden Tabelle definierten Konstanten sein.
In der Tabelle sind die möglichen Formatierungsmuster für negative Währungsbeträge aufgeführt. Wenn ein Währungsbetrag mit der
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Dieses Symbol wird mit dem Format für negative Währungsbeträge verwendet, wenn der formatierte Währungsbetrag kleiner als null ist. Es wird nicht verwendet bei Formaten für negative Währungsbeträge, die kein Negativsymbol enthalten (zum Beispiel, wenn negative Währungsbeträge in Klammern gesetzt werden).
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Der Wert dieser Eigenschaft muss eine der in der folgenden Tabelle definierten Konstanten sein.
In der Tabelle sind die möglichen Formatierungsmuster für positive Währungsbeträge aufgeführt. Wenn ein Währungsbetrag mit der
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Wenn der Wert
Wenn diese Eigenschaft den Wert
Lautet der Währungsbetrag beispielsweise 123.4 und diese Eigenschaft hat den Wert „true“, während die
Die folgende Tabelle enthält Beispiele für die Formatierung von Währungsbeträgen anhand der Werte für diese Eigenschaft und die verwandten Eigenschaften
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Wenn die
Wenn die
Die
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Diese Klasse nutzt die Dienste für den Stringvergleich, die vom Betriebssystem bereitgestellt werden. Die Vergleiche unterscheiden sich je nach Gebietsschema-ID, die beim Erstellen der Klasseninstanz angegeben wird. ActionScript speichert Strings mithilfe des Unicode-Zeichensatzes. Die booleschen Stringvergleichsoperatoren (==, !=, <, <=, >, >=) verwenden Unicode-Codepoints für den Vergleich. In den meisten Fällen stimmt die resultierende Sortierreihenfolge nicht mit den Konventionen einer bestimmten Sprache und Region überein und sollte deshalb nicht zum Sortieren von Strings verwendet werden, die in einer Benutzeroberfläche dargestellt werden. Im Gegensatz dazu bieten die Vergleichsmethoden in dieser Klasse eine Reihenfolge, die diese Konventionen beachtet.
Dies sind einige Beispiele, bei denen die Sortierreihenfolge von der Sprache abhängig ist:
Die Sortierreihenfolge kann je nach Verwendungszweck sogar innerhalb derselben Sprache und derselben Region variieren. In Deutschland gibt es zum Beispiel eine Sortierreihenfolge für die Namen in Telefonbüchern, die nicht mit der für Wörterbücher verwendeten übereinstimmt. Im Chinesischen und im Japanischen gibt es verschiedene Arten, die ideografischen Zeichen zu sortieren: nach Aussprache oder nach dem ideografischen Basiszeichen und der Anzahl der in der Glyphe verwendeten Striche. Im Spanischen und im Georgischen gibt es jeweils Unterschiede zwischen der modernen und der traditionellen Sortierung.
Die Vergleichsmethoden in dieser Klasse stellen zwei Hauptmodi bereit. Der
Auch wenn dem Konstruktor wie im Beispiel oben eine Gebietsschema-ID als Parameter übergeben wird, kann das Sortierverhalten variieren. Dies ist von den Betriebssystemeinstellungen des Benutzers und von der eventuellen Verwendung eines Ersatzgebietsschema bei nicht unterstütztem angeforderten Gebietsschema abhängig.
Wenn das aktuelle Betriebssystem die mit dem
Der
Dies ist ein Beispiel für eine sortierte Liste, die mit einem Collator erstellt wurde, mit der Gebietsschema-ID „en-US“ (Englisch, USA) und der
Wie oben gezeigt, werden alle Zeichen als unterschiedlich behandelt, aber in linguistischer Reihenfolge.
Dies ist ein Beispiel für eine sortierte Liste, die mit einem Collator erstellt wurde, mit der Gebietsschema-ID „en-US“ (Englisch, USA) und der
Legende: Zeichen in derselben Zeile werden beim Vergleichen/Sortieren als gleich behandelt. Beispiel: "a" (U+0040 = lateinisches kleines a) und "Ä" (U+00C4 = lateinisches großes A mit Umlaut) werden als gleich angesehen.
Wie oben gezeigt, stehen einige Zeichen in linguistisch korrekter Reihenfolge und werden wie gleiche Zeichenwerte behandelt.
Zur feineren Steuerung der Sortierreihenfolge können Sie Collator-Eigenschaften ändern, zum Beispiel
Zum Vergleich folgt ein entsprechendes Beispiel mit der Standardmethode
Wie Sie oben sehen können, sind alle Zeichen einfach in der Reihenfolge ihrer numerischen Unicode-Werte sortiert. Sprachlich ist dies nicht sinnvoll.
Um die Einstellungen des aktuellen Betriebssystems des Benutzers zu verwenden, übergeben Sie den statischen Wert
Für einige Gebietsschemas gibt es verschiedene Sortiervarianten. Im Deutschen werden zum Beispiel für Telefonbücher und Wörterbücher unterschiedliche Sortierreihenfolgen verwendet. Im Chinesischen werden Wörter normalerweise durch Transkriptionen der Zeichen in Pinyin unterstützt. Diese unterschiedlichen Sortierreihenfolgen lassen sich auswählen, indem das Schlüsselwort "collation" in den String eingefügt wird, der im
Mögliche Werte für den collation-String sind nachstehend aufgeführt, mit der betroffenen Sprache in Klammern:
Wenn die Hostplattform den angeforderten Sortiertyp nicht unterstützt, wird eine Ausweichlösung verwendet und die
Wenn der Konstruktor erfolgreich abgeschlossen wird, wird die
Wenn die angeforderte Gebietsschema-ID nicht verfügbar ist, hat die
Andernfalls wird die
Details zu den oben aufgeführten Warnungen und zu anderen möglichen Werten der
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die
Andernfalls wird die
Wenn diese Klasse vom aktuellen Betriebssystem gar nicht unterstützt wird, gibt diese Methode einen Null-Wert zurück.
Es drei Möglichkeiten für den Wert des Namens, abhängig vom Betriebssystem und dem Wert des
Beispiel:
var fmt:Collator = new Collator(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; Im obigen Beispiel ist
aliName der Name des Gebietsschemas, das den aktuellen Einstellungen im Betriebssystem des Benutzers entspricht (z. B. „it-IT“, wenn das Gebietsschema des Benutzers auf Italienisch-Italien eingestellt ist), und nicht"i-default" (der Name desLocaleID.DEFAULT -Gebietsschemas).
Zum Beispiel:
var fmt:Collator = new Collator("fr-CA"); var aliName:String = fmt.actualLocaleIDName; Wenn das im obigen Beispiel verwendete Betriebssystem die Gebietsschema-ID „fr-CA“ (Französisch-Kanada) nicht unterstützt, wird eine Ausweichlösung verwendet. In diesem Fall enthält die Variable
aliName die Ersatzgebietsschema-ID "fr-FR" (Französisch-Frankreich).
Bei der Umwandlung von Groß- und Kleinbuchstaben werden die Regeln für das angegebene Gebietsschema beachtet.
Wenn die
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Für die Kompatibilität mit vorhandenen Standards für chinesische und japanische Zeichensätze stellt Unicode Zeichencodes sowohl für Zeichen voller Breite als auch halber Breite bereit. Wenn zum Beispiel die
Wenn die
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Wenn die
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Wenn die
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Wenn die
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Wenn die
Wenn diese Eigenschaft den Wert
Wenn diese Eigenschaft zum Beispiel für das Gebietsschema "en-US" den Wert „true“ hat, werden die Strings "version1", "version10" und "version2" in dieser Reihenfolge sortiert: version1 < version2 < version10.
Wenn diese Eigenschaft für das Gebietsschema "en-US" den Wert „false“ hat, werden dieselben Strings in dieser Reihenfolge sortiert: version1 < version10 < version2.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die
Andernfalls wird die
Wenn der Wert