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 dieformat()
-Methode übergeben wird. (Ein leeres Argument ist zulässig.) -
"Invalid format"
bedeutet entweder, dass die EigenschaftformatString
auf leer ("") gesetzt ist oder dass weniger als ein Musterbuchstabe in der EigenschaftformatString
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.
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" />
Verwandte API-Elemente
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 |
Methode | Definiert von | ||
---|---|---|---|
Konstruktor. | DateFormatter | ||
[override]
Generiert einen datumsformatierten String aus einem datumsformatierten String oder einem Datumsobjekt. | DateFormatter | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
[statisch]
Konvertiert ein Datum, das als ein String formatiert ist, in ein Datumsobjekt. | DateFormatter | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
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):
|
M | Monat im Jahr. Das Format hängt von folgenden Kriterien ab:
|
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:
|
E | Tag in der Woche. Das Format hängt von folgenden Kriterien ab:
|
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:
|
S | Sekunde der Minute.
Beispiel:
|
Q | Millisekunde der Sekunde.
Beispiel:
|
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:
|
Der Standardwert ist "MM/DD/YYYY".
Implementierung
public function get formatString():String
public function set formatString(value:String):void
DateFormatter | () | Konstruktor |
public function DateFormatter()
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
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.
|
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.
|
Date — Datumsobjekt.
|
Verwandte API-Elemente
<?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>
Tue Jun 12 2018, 10:04 AM Z