DateFormatter

Paket	mx.formatters
Klasse	public class DateFormatter
Vererbung	DateFormatter Formatter Object
Unterklassen	ExpiryDateFormat

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Beginnend mit Flex 4.5 empfiehlt Adobe die Verwendung der Klasse spark.formatters.DateTimeFormatter als Alternative zu dieser Klasse.

Die DateFormatter-Klasse verwendet einen Formatstring, um einen formatierten Datum- und Uhrzeitstring aus einem Eingabestring oder einem Datumsobjekt zurückzugeben. Sie können einfach viele Varianten erstellen, einschließlich internationaler Formate.

Wenn ein Fehler aufgetreten ist, wird ein leerer String zurückgegeben und ein den Fehler beschreibender String wird in der Eigenschaft error gespeichert. Die Eigenschaft error kann einen der folgenden Werte aufweisen:

"Invalid value" bedeutet, dass ein Wert, der kein Datumsobjekt oder keine erkannte Stringdarstellung eines Datums ist, an die format()-Methode übergeben wird. (Ein leeres Argument ist zulässig.)
"Invalid format" bedeutet entweder, dass die Eigenschaft formatString auf leer ("") gesetzt ist oder dass weniger als ein Musterbuchstabe in der Eigenschaft formatString enthalten ist.

Die parseDateString()-Methode verwendet die mx.formatters.DateBase-Klasse zum Definieren der Informationen des lokalisierten Strings, die zum Konvertieren eines als ein String in einem Datumsobjekt formatierten Datums erforderlich sind.

MXML-Syntax expanded

MXML-Syntax ausblenden

You use the <mx:DateFormatter> tag to render date and time Strings from a Date object.

The <mx:DateFormatter> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:DateFormatter
    formatString="Y|M|D|A|E|H|J|K|L|N|S|Q"
   />

Beispiele anzeigen

Verwandte API-Elemente

mx.formatters.DateBase

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		error : String Beschreibung, die von der Formatierung gespeichert wird, wenn ein Fehler auftritt.	Formatter
		formatString : String Das Maskenmuster.	DateFormatter

Geschützte Eigenschaften

Vererbte geschützte Eigenschaften ausblenden

Vererbte geschützte Eigenschaften anzeigen

	Eigenschaft		Definiert von
		resourceManager : IResourceManager [schreibgeschützt] Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet.	Formatter

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		DateFormatter() Konstruktor.	DateFormatter
		format(value:Object):String [override] Generiert einen datumsformatierten String aus einem datumsformatierten String oder einem Datumsobjekt.	DateFormatter
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		parseDateString(str:String):Date [statisch] Konvertiert ein Datum, das als ein String formatiert ist, in ein Datumsobjekt.	DateFormatter
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Geschützte Methoden

Vererbte geschützte Methoden ausblenden

Vererbte geschützte Methoden anzeigen

	Methode		Definiert von
		resourcesChanged():void Diese Methode wird aufgerufen, wenn eine Formatierung erstellt wird, und wird erneut aufgerufen, wenn ResourceManager ein „change“-Ereignis auslöst, um anzugeben, dass sich die lokalisierten Ressourcen geändert haben.	Formatter

Eigenschaftendetails

formatString

Eigenschaft

formatString:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Das Maskenmuster.

Sie verfassen einen Musterstring mithilfe von bestimmten Großbuchstaben, beispielsweise: YYYY/MM.

Der DateFormatter-Musterstring kann weiteren Text außer den Musterbuchstaben enthalten. Um einen gültigen Musterstring zu erstellen, benötigen Sie nur einen Musterbuchstaben.

In der folgenden Tabelle werden die gültigen Musterbuchstaben beschrieben:

Musterbuchstabe	Beschreibung
Y	Jahr. Wenn die Anzahl der Musterbuchstaben zwei beträgt, wird das Jahr in zwei Stellen unterteilt. Andernfalls wird es mit vier Stellen angezeigt. Beim Jahr kann eine Null voranstehen (siehe drittes der folgenden Beispiele): YY = 05 YYYY = 2005 YYYYY = 02005
M	Monat im Jahr. Das Format hängt von folgenden Kriterien ab: Wenn die Anzahl der Musterbuchstaben eins beträgt, wird das Format als numerischer Wert mit einer oder zwei Stellen interpretiert. Wenn die Anzahl der Musterbuchstaben zwei beträgt, wird das Format als numerischer Wert mit zwei Stellen interpretiert. Wenn die Anzahl der Musterbuchstaben drei beträgt, wird das Format als Kurztext interpretiert. Wenn die Anzahl der Musterbuchstaben vier beträgt, wird das Format als vollständiger Text interpretiert. Beispiele: M = 7 MM= 07 MMM=Jul MMMM= July
D	Tag im Monat. Obwohl ein Musterstring aus einem Buchstaben für den Tag gültig ist, verwenden Sie normalerweise einen Musterstring aus zwei Buchstaben. Beispiele: D=4 DD=04 DD=10
E	Tag in der Woche. Das Format hängt von folgenden Kriterien ab: Wenn die Anzahl der Musterbuchstaben eins beträgt, wird das Format als numerischer Wert mit einer oder zwei Stellen interpretiert. Wenn die Anzahl der Musterbuchstaben zwei beträgt, wird das Format als numerischer Wert mit zwei Stellen interpretiert. Wenn die Anzahl der Musterbuchstaben drei beträgt, wird das Format als Kurztext interpretiert. Wenn die Anzahl der Musterbuchstaben vier beträgt, wird das Format als vollständiger Text interpretiert. Beispiele: E = 1 EE = 01 EEE = Mon EEEE = Monday
A	Angabe für Vormittag/Nachmittag (am/pm).
J	Stunde des Tages (0-23).
H	Stunde des Tages (1-24).
K	Stunde am Vormittag/Nachmittag (am/pm) (0-11).
L	Stunde am Vormittag/Nachmittag (am/pm) (1-12).
N	Minute der Stunde. Beispiele: N = 3 NN = 03
S	Sekunde der Minute. Beispiel: SS = 30
Q	Millisekunde der Sekunde. Beispiel: QQ = 78 QQQ = 078
Weiterer Text	Sie können weiteren Text zum Musterstring hinzufügen, um den String weiter zu formatieren. Sie können Interpunktion, Zahlen und alle Kleinbuchstaben verwenden. Sie sollten Großbuchstaben vermeiden, da sie als Musterbuchstaben interpretiert werden könnten. Beispiel: EEEE, MMM. D, YYYY at L:NN:QQQ A = Tuesday, Sept. 8, 2005 at 1:26:012 PM

Der Standardwert ist "MM/DD/YYYY".

Implementierung
public function get formatString():String
public function set formatString(value:String):void

Konstruktordetails

()

Konstruktor

public function DateFormatter()

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Methodendetails

format

()

Methode

override public function format(value:Object):String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Generiert einen datumsformatierten String aus einem datumsformatierten String oder einem Datumsobjekt. Die Eigenschaft formatString bestimmt das Format des Ausgabestrings. Wenn value nicht formatiert werden kann, wird ein leerer String zurückgegeben und eine Beschreibung des Fehlers in der Eigenschaft error geschrieben.

Parameter

value:Object — Das zu formatierende Datum. Dabei kann es sich um ein Datumsobjekt oder einen datumsformatierten String wie „Thursday, April 22, 2004“ handeln.

Rückgabewerte

String — Formatierter String. Leer, wenn ein Fehler auftritt. Eine Beschreibung der Fehlerbedingung wird in die Eigenschaft error geschrieben.

parseDateString

()

Methode

public static function parseDateString(str:String):Date

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konvertiert ein Datum, das als ein String formatiert ist, in ein Datumsobjekt. Monats- und Tagesnamen müssen mit den Namen in mx.formatters.DateBase übereinstimmen. Der Stundenwert im String muss zwischen 0 und 23 (einschließlich) liegen. Der Wert für Minuten und Sekunden im String muss zwischen 0 und 59 (einschließlich) liegen. Das folgende Beispiel verwendet diese Methode, um einen Date-Objekt zu erstellen.

      var myDate:Date = DateFormatter.parseDateString("2009-12-02 23:45:30");

Parameter

str:String — Das Datum, das als ein String formatiert ist.

Rückgabewerte

Date — Datumsobjekt.

Verwandte API-Elemente

mx.formatters.DateBase

Beispiele Verwendung dieses Beispiels

DateFormatterExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the DateFormatter. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/mx">

    <fx:Script>
        <![CDATA[
            import mx.events.ValidationResultEvent;

            private var vResult:ValidationResultEvent;

            // Event handler to validate and format input.
            private function Format():void {
                vResult = dateVal.validate();
                if (vResult.type == ValidationResultEvent.VALID) {
                    formattedDate.text = dateFormatter.format(dob.text);
                } else {
                    formattedDate.text = "";
                }
            }
        ]]>
    </fx:Script>

    <fx:Declarations>
        <mx:DateFormatter id="dateFormatter" formatString="month: MM, day: DD, year: YYYY"/>
        <mx:DateValidator id="dateVal" source="{dob}" property="text" inputFormat="mm/dd/yyyy"/>
    </fx:Declarations>

    <s:Panel title="DateFormatter Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0">
        <mx:Form left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Enter date (mm/dd/yyyy):" width="100%">
                <s:TextInput id="dob" text=""/>
            </mx:FormItem>
            <mx:FormItem label="Formatted date: " width="100%">
                <s:TextInput id="formattedDate" text="" editable="false"/>
            </mx:FormItem>
            <mx:FormItem>
                <s:Button label="Validate and Format" click="Format();"/>
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

</s:Application>

Rechtliche Hinweise | Onlinedatenschutzerklärung

DateFormatter - AS3 Flex

Paketex

Sprachelemente

Anhänge

Paket mx.formatters

formatString

DateFormatter

format

parseDateString