DateFormatter

Paket	mx.formatters
Sınıf	public class DateFormatter
Miras Alma	DateFormatter Formatter Object
Alt Sınıflar	ExpiryDateFormat

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 3

Çalışma Zamanı Sürümleri:

Flash Player 9, AIR 1.1

Flex 4.5 sürümünden itibaren, Adobe bu sınıfa alternatif olarak spark.formatters.DateTimeFormatter sınıfını kullanmanızı önerir.

The DateFormatter class uses a format String to return a formatted date and time String from an input String or a Date object. You can create many variations easily, including international formats.

If an error occurs, an empty String is returned and a String describing the error is saved to the error property. The error property can have one of the following values:

"Invalid value" means a value that is not a Date object or a is not a recognized String representation of a date is passed to the format() method. (An empty argument is allowed.)
"Invalid format" means either the formatString property is set to empty (""), or there is less than one pattern letter in the formatString property.

The parseDateString() method uses the mx.formatters.DateBase class to define the localized string information required to convert a date that is formatted as a String into a Date object.

MXML Sözdizimi expanded

MXML Sözdizimini Gizle

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"
   />

Örnekleri görüntüle

İlgili API Öğeleri

mx.formatters.DateBase

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		constructor : Object Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.	Object
		error : String Description saved by the formatter when an error occurs.	Formatter
		formatString : String The mask pattern.	DateFormatter

Korunan Özellikler

Miras Alınan Korunan Özellikleri Gizle

Miras Alınan Korunan Özellikleri Göster

	Özellik		Tanımlayan:
		resourceManager : IResourceManager [salt okunur] A reference to the object which manages all of the application's localized resources.	Formatter

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		DateFormatter() Constructor.	DateFormatter
		format(value:Object):String [geçersiz kıl] Generates a date-formatted String from either a date-formatted String or a Date object.	DateFormatter
		hasOwnProperty(name:String):Boolean Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.	Object
		isPrototypeOf(theClass:Object):Boolean Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.	Object
		parseDateString(str:String):Date [statik] Converts a date that is formatted as a String into a Date object.	DateFormatter
		propertyIsEnumerable(name:String):Boolean Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.	Object
		toLocaleString():String Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.	Object
		toString():String Belirtilen nesnenin dize olarak temsil edilen halini döndürür.	Object
		valueOf():Object Belirtilen nesnenin temel değerini döndürür.	Object

Korunan Yöntemler

Miras Alınan Korunan Yöntemleri Gizle

Miras Alınan Korunan Yöntemleri Göster

	Yöntem		Tanımlayan:
		resourcesChanged():void This method is called when a Formatter is constructed, and again whenever the ResourceManager dispatches a "change" Event to indicate that the localized resources have changed in some way.	Formatter

Özellik Ayrıntısı

formatString

özellik

formatString:String

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 3

Çalışma Zamanı Sürümleri:

Flash Player 9, AIR 1.1

The mask pattern.

You compose a pattern String using specific uppercase letters, for example: YYYY/MM.

The DateFormatter pattern String can contain other text in addition to pattern letters. To form a valid pattern String, you only need one pattern letter.

The following table describes the valid pattern letters:

Pattern letter	Description
Y	Year. If the number of pattern letters is two, the year is truncated to two digits; otherwise, it appears as four digits. The year can be zero-padded, as the third example shows in the following set of examples: YY = 05 YYYY = 2005 YYYYY = 02005
M	Month in year. The format depends on the following criteria: If the number of pattern letters is one, the format is interpreted as numeric in one or two digits. If the number of pattern letters is two, the format is interpreted as numeric in two digits. If the number of pattern letters is three, the format is interpreted as short text. If the number of pattern letters is four, the format is interpreted as full text. Examples: M = 7 MM= 07 MMM=Jul MMMM= July
D	Day in month. While a single-letter pattern string for day is valid, you typically use a two-letter pattern string. Examples: D=4 DD=04 DD=10
E	Day in week. The format depends on the following criteria: If the number of pattern letters is one, the format is interpreted as numeric in one or two digits. If the number of pattern letters is two, the format is interpreted as numeric in two digits. If the number of pattern letters is three, the format is interpreted as short text. If the number of pattern letters is four, the format is interpreted as full text. Examples: E = 1 EE = 01 EEE = Mon EEEE = Monday
A	am/pm indicator.
J	Hour in day (0-23).
H	Hour in day (1-24).
K	Hour in am/pm (0-11).
L	Hour in am/pm (1-12).
N	Minute in hour. Examples: N = 3 NN = 03
S	Second in minute. Example: SS = 30
Q	Millisecond in second Example: QQ = 78 QQQ = 078
Other text	You can add other text into the pattern string to further format the string. You can use punctuation, numbers, and all lowercase letters. You should avoid uppercase letters because they may be interpreted as pattern letters. Example: EEEE, MMM. D, YYYY at L:NN:QQQ A = Tuesday, Sept. 8, 2005 at 1:26:012 PM

Varsayılan değer şudur "MM/DD/YYYY".

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

Yapıcı Ayrıntı

()

Yapıcı

public function DateFormatter()

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 3

Çalışma Zamanı Sürümleri:

Flash Player 9, AIR 1.1

Constructor.

Yöntem Ayrıntısı

format

()

yöntem

override public function format(value:Object):String

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 3

Çalışma Zamanı Sürümleri:

Flash Player 9, AIR 1.1

Generates a date-formatted String from either a date-formatted String or a Date object. The formatString property determines the format of the output String. If value cannot be formatted, return an empty String and write a description of the error to the error property.

Parametreler

value:Object — Date to format. This can be a Date object, or a date-formatted String such as "Thursday, April 22, 2004".

Döndürür

String — Formatted String. Empty if an error occurs. A description of the error condition is written to the error property.

parseDateString

()

yöntem

public static function parseDateString(str:String):Date

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 3

Çalışma Zamanı Sürümleri:

Flash Player 9, AIR 1.1

Converts a date that is formatted as a String into a Date object. Month and day names must match the names in mx.formatters.DateBase. The hour value in the String must be between 0 and 23, inclusive. The minutes and seconds value must be between 0 and 59, inclusive. The following example uses this method to create a Date object:

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

Parametreler

str:String — Date that is formatted as a String.

Döndürür

Date — Date object.

İlgili API Öğeleri

mx.formatters.DateBase

Örnekler Bu örnek nasıl kullanılır?

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>

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

DateFormatter - AS3 Flex

Sınıflar x

formatString

DateFormatter

format

parseDateString