DateTimeFormatter  - AS3

Der Name der Gebietsschema-ID, die von diesem DateTimeFormatter-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, erhält Ihre Anwendung diese benutzerdefinierten Einstellungen nicht.
3. Wenn das System den im Konstruktor angegebenen requestedLocaleIDName nicht unterstützt, wird ein Ersatzgebietsschema bereitgestellt.

Verwandte API-Elemente

Der Status der vorherigen Operation, die dieses DateTimeFormatter-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.

Verwandte API-Elemente

Der Name der angeforderten Gebietsschema-ID, der an den Konstruktor dieses DateTimeFormatter-Objekts übergeben wurde.

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.

Verwandte API-Elemente

Konstruiert ein neues DateTimeFormatter-Objekt, um Datum- und Uhrzeitangaben gemäß den Konventionen des angegebenen Gebietsschemas und den bereitgestellten Formatierungsstilen für Datum und Uhrzeit zu formatieren. Mit Datums- und Uhrzeitstilen werden Muster für die Formatierung von Datum und Uhrzeit auf vordefinierte, vom Gebietsschema abhängige Muster vom Betriebssystem eingestellt.

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 actualLocaleIDName-Eigenschaft bestimmt werden.

Wenn ein Ersatz für einen der Parameter requestedLocaleIDName, dateStyle oder timeStyle verwendet wird, wird die lastOperationStatus-Eigenschaft festgelegt, um den Ersatztyp anzugeben.

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 aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• 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

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.

Verwandte API-Elemente

Formatiert einen Anzeigestring für ein Date-Objekt, das als in der Zeitzone des Benutzers befindlich interpretiert wird (unter Verwendung der lokalen Zeitkomponenten des Date-Objekts wie: date, day, fullYear, hours, minutes, month und seconds). Die Formatierung erfolgt unter Verwendung der Konventionen der Gebietsschema-ID und von Datums- und Uhrzeitstil, oder anhand von benutzerdefinierten Datums- und Uhrzeitmustern, die für diese DateTimeFormatter-Instanz angegeben wurden.

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

Verwandte API-Elemente

Formatiert einen Anzeigestring für ein Date-Objekt, das als in der UTC-Zeit ausgedrückt interpretiert wird (unter Verwendung der UTC-Komponenten des Date-Objekts wie: dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC und secondsUTC), entsprechend des dateStyle-, timeStyle- oder date-Zeitmusters. Die Formatierung erfolgt unter Verwendung der Konventionen der Gebietsschema-ID und von Datums- und Uhrzeitstil, oder anhand von benutzerdefinierten Datums- und Uhrzeitmustern, die für diese DateTimeFormatter-Instanz angegeben wurden.

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

Verwandte API-Elemente

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.

Verwandte API-Elemente

Ruft den Datumsstil für diese DateTimeFormatter-Instanz ab. Der Datumsstil wird verwendet, um ein vordefiniertes Muster für die Datumsformatierung vom Betriebssystem abzurufen. Der Wert für den Datumsstil kann vom DateTimeFormatter()-Konstruktor, von der setDateTimeStyles()-Methode oder von der setDateTimePattern()-Methode festgelegt werden.

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.

Verwandte API-Elemente

Gibt den Musterstring zurück, der von diesem DateTimeFormatter-Objekt für die Formatierung von Datums- und Uhrzeitangaben verwendet wird.

Dieses kann auf drei Arten festgelegt werden:

1. mit den im Konstruktor verwendeten dateStyle- und timeStyle-Parametern
2. mit der setDateTimeStyles()-Methode
3. mit der setDateTimePattern()-Methode

Eine Beschreibung der Syntax finden Sie im Abschnitt zur setDateTimePattern()-Methode.

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.

Verwandte API-Elemente

Gibt eine Ganzzahl zurück, die dem ersten Tag der Woche für dieses Gebietsschema und dieses Kalendersystem entspricht. Der Wert 0 entspricht Sonntag, 1 Montag usw., 6 entspricht Samstag.

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.

Verwandte API-Elemente

Ruft eine Liste lokalisierter Strings mit den Monatsnamen für das aktuelle Kalendersystem ab. Das erste Element in der Liste ist der Name für den ersten Monat des Jahres.

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

Verwandte API-Elemente

Ruft den Uhrzeitstil für diese DateTimeFormatter-Instanz ab. Der Uhrzeitstil wird verwendet, um ein vordefiniertes Muster für die Uhrzeitformatierung vom Betriebssystem abzurufen. Der Wert für den Uhrzeitstil kann vom DateTimeFormatter()-Konstruktor, von der setDateTimeStyles()-Methode oder von der setDateTimePattern()-Methode festgelegt werden.

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.

Verwandte API-Elemente

Ruft eine Liste lokalisierter Strings mit den Namen der Wochentage für das aktuelle Kalendersystem ab. Das erste Element in der Liste repräsentiert den Namen für Sonntag.

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

Verwandte API-Elemente

Legt den Musterstring fest, der von diesem DateTimeFormatter-Objekt für die Formatierung von Datums- und Uhrzeitangaben verwendet wird.

Das Muster für die Formatierung von Datumsangaben kann auf drei Arten festgelegt werden:

1. mit den im Konstruktor verwendeten dateStyle- und timeStyle-Parametern
2. mit der setDateTimeStyles()-Methode
3. mit dieser setDateTimePattern()-Methode

Als Nebeneffekt dieser Methode werden die aktuellen Uhrzeit- und Datumsstile für dieses DateTimeFormatter-Objekt überschrieben und auf den Wert DateTimeStyle.CUSTOM gesetzt.

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:

• MMMMMM wird durch MMMM ersetzt
• dddd wird durch dd ersetzt
• EEEEEEE wird durch EEEE ersetzt
• aa wird durch a ersetzt
• hhh wird durch hh ersetzt
• mmmm wird durch mm ersetzt

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 lastOperationStatus-Eigenschaft auf den Wert LastOperationStatus.PATTERN_SYNTAX_ERROR gesetzt.

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 lastOperationStatus-Eigenschaft gibt an, dass ein Fallback (Ersatz) verwendet wurde. Falls kein angemessenes Ersatzmuster bereitgestellt wird, wird ein leerer String verwendet und die lastOperationStatus-Eigenschaft gibt an, dass das Muster nicht unterstützt wurde.

In der folgenden Tabelle sind die gültigen Musterbuchstaben und ihre Bedeutung aufgeführt.

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

Verwandte API-Elemente

Legt den Stil für Datums- und Uhrzeitangaben für diese DateTimeFormatter-Instanz fest. Mit Datums- und Uhrzeitstilen werden Muster für die Formatierung von Datum und Uhrzeit auf vordefinierte, vom Gebietsschema abhängige Muster vom Betriebssystem eingestellt. Diese Methode ersetzt die Stile, die mit dem DateTimeFormatter()-Konstruktor oder der setDateTimePattern()-Methode festgelegt wurden. Das Datums- und Uhrzeitmuster wird ebenfalls anhand der festgelegten Stile aktualisiert.

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

Verwandte API-Elemente

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:

1. Erstellt ein DateTimeFormatter-Objekt mit dem Standardstil (long dateStyle, long timeStyle).
2. Formatiert das aktuelle Datum und die Uhrzeit unter Verwendung des standardmäßigen langen Datumsstils.
3. Wechsel zu einem kurzem Datumsstil (nur Uhrzeit) mithilfe der Konstanten DateTimeStyle.NONE und DateTimeStyle.SHORT.
4. Formatiert das aktuelle Datum und die Uhrzeit unter Verwendung des standardmäßigen kurzen Datumsstils (nur Uhrzeit).

package {
    import flash.display.Sprite;
    import flash.globalization.DateTimeFormatter;
    import flash.globalization.DateTimeStyle;
    
    public class DateTimeFormatterExample extends Sprite
    {    
        private var localeList:Array = new Array("en-US", "fr-FR", "es-ES");
    
        public function DateTimeFormatterExample()
        {
            var date:Date = new Date();
            
            for each (var locale:String in localeList) {
                var dtf:DateTimeFormatter = new DateTimeFormatter(locale);
                trace('\n' + "LocaleID requested=" + dtf.requestedLocaleIDName 
                    + "; actual=" + dtf.actualLocaleIDName);
            
                var longDate:String = dtf.format(date);
                trace(longDate + " (" + dtf.getDateTimePattern() + ")");
            
                dtf.setDateTimeStyles(DateTimeStyle.NONE, DateTimeStyle.SHORT);
                var shortDate:String = dtf.format(date);
                trace(shortDate + " (" + dtf.getDateTimePattern() + ")");
            }        
        }
    }
}

Das Beispiel führt für jedes Gebietsschema in der Liste Folgendes aus:

1. Erstellt drei Eingabe- und Ausgabetextfelder.
2. Erstellt ein DateTimeFormatter-Objekt unter Verwendung des Gebietsschemas für amerikanisches Englisch.
3. Ruft die configureTextField()-Funktion auf, die die Position und die Größe der Textfelder festlegt, und fügt einen Ereignis-Listener für das patternField-Objekt hinzu.
4. Wenn der Benutzer das Muster in das Textfeld patternField eingibt, formatiert die textInputHandler-Funktion das aktuelle Datum und die Uhrzeit anhand dieses Musters und zeigt das Ergebnis und den Wert von lastOperationStatus in den Ausgabetextfeldern an.

 
package {  
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.globalization.DateTimeFormatter;
    import flash.text.*;
    
    public class DateTimePatternExample extends Sprite
    {    
        private var patternField:TextField = new TextField();
        private var resultField:TextField = new TextField();
        private var statusField:TextField = new TextField();
           private var date:Date = new Date();
         private var dtf:DateTimeFormatter = new DateTimeFormatter("en-US");           
         
        private function configureTextField():void
        {
            patternField.type = TextFieldType.INPUT;
            patternField.width = 300;
            patternField.height = 20;
            patternField.background = true;
            patternField.border = true;
            
            resultField.y = 40;
            resultField.width = 300;
            resultField.height = 20;
            
            statusField.y = 80;
            statusField.width = 300;
            statusField.height = 20;

            addChild(patternField);
            addChild(resultField);
            addChild(statusField);
            patternField.addEventListener(Event.CHANGE,textInputHandler);
        }

        private function textInputHandler(event:Event):void
        {                 
            dtf.setDateTimePattern(patternField.text);
            statusField.text = dtf.lastOperationStatus;
            resultField.text = dtf.format(date);
        }

        public function DateTimePatternExample()
        {
            configureTextField();    
        }
    }
}