This page was saved using jaction on 2006-09-04 8:33:37.
Address: http://flexdocs.kr/docs/flex2/langref/mx/formatters/DateFormatter.html
Title: mx.formatters.DateFormatter (Flex™ 2 레퍼런스 가이드)  •  Size: 34356
Packagemx.formatters
Classpublic class DateFormatter
InheritanceDateFormatter Inheritance Formatter Inheritance Object

DateFormatter 클래스는, 포맷 한 string를 사용해 string 또는 Date object로부터 일자 및 시각의 string를 렌더링 합니다. 국제적인 형식을 시작해 다양한 형식을 작성할 수 있습니다.

에러가 발생하면, empty의 string가 돌려주어져 에러를 설명하는 string가 error property에 보존됩니다. 이 error property로 지정할 수 있는 값은, 다음 가운데 머지않아인가입니다.

MXML 문장구조법expandedMXML 문장구조법의 비표시

<mx:DateFormatter> 태그를 사용해, Date object로부터 일시 string를 렌더링 합니다.

<mx:DateFormatter> 태그는, Super 클래스의 모든 태그 속성을 Inheritance해, 다음의 태그 속성을 추가합니다.

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

View the examples

See also

mx.formatters.DateBase


Public property
 property정의
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
 Inheritederror : String
에러가 발생했을 때에 Formatter에 의해 보존되는 설명을 나타냅니다.
Formatter
  formatString : String
마스크 패턴을 나타냅니다.
DateFormatter
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
Protected property
 property정의
 InheriteddefaultInvalidFormatError : String = "Invalid format"
무효인 포맷 string가 formatter로 지정된 것을 나타내는 에러 메세지입니다.
Formatter
 InheriteddefaultInvalidValueError : String = "Invalid value"
무효인 값이 formatter로 지정된 것을 나타내는 에러 메세지입니다.
Formatter
 InheritedpackageResources : ResourceBundle
[static] formatters.properties 로부터의 모든 심볼을 포함한 ResourceBundle object입니다.
Formatter
Public Methods
 Methods정의
  DateFormatter ()
constructor   .
DateFormatter
  format (value:Object ):String
string를 일자로서 포맷 합니다.
DateFormatter
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
Protected Methods
 Methods정의
  parseDateString (str:String ):Date
[static] Date object에 string로서 포맷 한 일자를 변환합니다.
DateFormatter
property의 상세
formatStringproperty
public var formatString:String

마스크 패턴을 나타냅니다.

패턴 string는 다음과 같이 특정의 대문자를 사용해 구성합니다. YYYY/MM.

DateFormatter 패턴 string에는, 패턴 캐릭터에 가세해 그 이외의 텍스트를 포함할 수가 있습니다. 패턴 string는 1 캐릭터의 패턴 캐릭터만으로 유효하게 됩니다.

다음의 겉(표)는, 유효한 패턴 캐릭터를 기술하고 있습니다.

패턴 캐릭터설명
Y 해입니다. 패턴 캐릭터의 수가 2 의 경우, 해는 2 자리수에 절약할 수 있습니다. 그 이외의 경우, 4 자리수로 표시됩니다. 다음의 예의 3 번째에 나타내도록(듯이), 지정된 자리수가 되도록(듯이) 0 이 추가됩니다.

YY = 05

YYYY = 2005

YYYYY = 02005
M 월명입니다. 형식은, 다음의 조건에 의해 정해집니다.
  • 패턴 캐릭터의 수가 1 개의 경우, 형식은 1 자리수 또는 2 자리수의 수치로서 해석됩니다.
  • 패턴 캐릭터의 수가 2 개의 경우, 형식은 2 자리수의 수치로서 해석됩니다.
  • 패턴 캐릭터의 수가 3 개의 경우, 형식은 생략 한 텍스트로서 해석됩니다.
  • 패턴 캐릭터의 수가 4 개의 경우, 형식은 생략 되지 않는 텍스트로서 해석됩니다.
례:

M = 7

MM= 07

MMM=Jul

MMMM= July
D 일자입니다. 1 캐릭터의 일자 패턴 string도 유효합니다만, 통상은 2 캐릭터의 패턴 string를 사용합니다.

례:

D=4

DD=04

DD=10
E 요일입니다. 형식은, 다음의 조건에 의해 정해집니다.
  • 패턴 캐릭터의 수가 1 개의 경우, 형식은 1 자리수 또는 2 자리수의 수치로서 해석됩니다.
  • 패턴 캐릭터의 수가 2 개의 경우, 형식은 2 자리수의 수치로서 해석됩니다.
  • 패턴 캐릭터의 수가 3 개의 경우, 형식은 생략 한 텍스트로서 해석됩니다.
  • 패턴 캐릭터의 수가 4 개의 경우, 형식은 생략 되지 않는 텍스트로서 해석됩니다.
례:

E = 1

EE = 01

EEE = Mon

EEEE = Monday
A 오전/오후를 나타냅니다.
J 시각 (0 ~ 23)입니다.
H 시각 (1 ~ 24)입니다.
K 오전/오후에 단락지었을 때 각 (0 ~ 11)입니다.
L 오전/오후에 단락지었을 때 각 (1 ~ 12)입니다.
N 분수입니다.

례:

N = 3

NN = 03
S 초수입니다.

례:

SS = 30
그 외의 텍스트 그 외의 텍스트를 패턴 string에 추가해, string를 한층 더 설정할 수가 있습니다. 구두점이나 숫자, 임의의 소문자를 사용할 수 있습니다. 대문자는 패턴 캐릭터로서 해석되는 경우가 있기 (위해)때문에, 대문자는 사용하지 말아 주세요.

례:

EEEE, MMM.D, YYYY at H:NN A = Tuesday, Sept. 8, 2003 at 1:26 PM

디폴트치"MM/DD/YYYY".

constructor    의 상세
DateFormatter()constructor   
public 함수 DateFormatter()

constructor   .

Methods의 상세
format()Methods
public override function format(value:Object ):String

string를 일자로서 포맷 합니다. 출력 string의 포맷은 formatString property에 의해 정해집니다. value 를 포맷 할 수 없는 경우, empty의 string가 돌려주어져error property에 에러의 설명이 기입해집니다.

Parameters
value:Object — 포맷 하는 일자를 나타냅니다. 이것에는, Date object, 또는 "Thursday, April 22, 2004" 등의 일자 string를 지정할 수 있습니다.

반환값
String — 포맷 한 string를 나타냅니다. 에러가 발생했을 경우는 empty입니다. 에러 상태를 나타내는 설명이 error property에 기입해집니다.
parseDateString()Methods 
protected static function parseDateString(str:String ):Date

Date object에 string로서 포맷 한 일자를 변환합니다. 월명과 요일명은 mx.formatters.DateBase 내의 이름에 일치할 필요가 있습니다.

Parameters
str:String — string로서 포맷 한 일자를 나타냅니다.

반환값
Date — Date object.

See also

Examples
DateFormatterExample
<? xml version="1.0" encoding="utf-8"? >
<! -- Simple example to demonstrate the DateFormatter.  -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx: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= "";
                }
            }
        ]]>
    </mx:Script>

    <mx:DateFormatter id="dateFormatter" formatString="month: MM, day: DD, year: YYYY"/>

    <mx:DateValidator id="dateVal" source="{dob}" property="text" inputFormat="mm/dd/yyyy"/>

    <mx:Panel title="DateFormatter Example" width="95%" height="95%" 
            paddingTop="10" paddingLeft="5" paddingRight="5" paddingBottom="10">

        <mx:Form width="100%">
            <mx:FormItem label="Enter date (mm/dd/yyyy):" width="100%">
                <mx:TextInput id="dob" text=""/>
            </mx:FormItem>

            <mx:FormItem label="Formatted date: " width="100%">
                <mx:TextInput id="formattedDate" text="" editable="false"/>
            </mx:FormItem>

            <mx:FormItem>
                <mx:Button label="Validate and Format" click="Format();"/>
            </mx:FormItem>
        </mx:Form>

    </mx:Panel>
</mx:Application>






 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/formatters/DateFormatter.html