DateTimeFormatter  - AS3

이 DateTimeFormatter 객체에서 사용되는 실제 로캘 ID의 이름입니다.

운영 체제와 Collator() 생성자에 전달된 requestedLocaleIDName 매개 변수의 값에 따라 세 가지 이름 값이 가능합니다.

1. 요청된 로캘이 LocaleID.DEFAULT가 아니고 운영 체제에서 요청된 로캘을 지원하는 경우 requestedLocaleIDName 속성과 같은 이름이 반환됩니다.
2. LocaleID.DEFAULT가 생성자에 전달되는 requestedLocaleIDName 매개 변수의 값으로 사용된 경우 사용자의 운영 체제에서 지정된 현재 로캘의 이름이 사용됩니다. LocaleID.DEFAULT 값은 OS의 사용자 정의된 설정을 유지합니다. requestedLocaleIDName 매개 변수로 명시적 값을 전달하면 두 로캘 ID 이름이 같아도 LocaleID.DEFAULT를 사용할 때의 결과와 달라질 수 있습니다. 사용자가 컴퓨터에 로캘 설정을 사용자 정의했을 경우 LocaleID.DEFAULT를 사용하는 대신 명시적 로캘 ID 이름을 요청하면 응용 프로그램에서 사용자 정의된 설정을 검색하지 못합니다.
3. 운영 체제가 생성자에 지정된 requestedLocaleIDName을 지원하지 않는 경우 대체 로캘 ID 이름이 제공됩니다.

관련 API 요소

이 DateTimeFormatter 객체에서 수행한 이전 작업의 상태입니다. lastOperationStatus 속성은 이 클래스의 생성자 또는 메서드가 호출되거나 다른 속성이 설정될 때마다 설정됩니다. 가능한 값은 각 메서드의 설명을 참조하십시오.

관련 API 요소

이 DateTimeFormatter 객체의 생성자에 전달된 요청된 로캘 ID의 이름입니다.

LocaleID.DEFAULT 값이 사용된 경우 "i-default"가 반환됩니다. 대체 로캘이 적용된 경우 사용된 실제 로캘은 요청된 로캘과 다를 수 있습니다. 실제 로캘 이름은 actualLocaleIDName 속성을 사용하여 검색할 수 있습니다.

관련 API 요소

지정된 로캘의 규칙과 제공된 날짜 및 시간 서식 스타일에 따라 날짜 및 시간의 서식을 지정하는 새 DateTimeFormatter 객체를 생성합니다. 날짜 및 시간 스타일은 날짜 및 시간 서식 패턴을 운영 체제에서 미리 정의된 로캘 종속 패턴으로 설정하는 데 사용됩니다.

이 생성자는 현재 운영 체제에서 요청된 ID 이름을 지원하는지 여부를 결정합니다. 지원되지 않으면 대체 로캘이 대신 사용됩니다. 대체 로캘 ID의 이름은 actualLocaleIDName 속성에서 결정할 수 있습니다.

대체 로캘이 requestedLocaleIDName, dateStyle 또는 timeStyle 매개 변수에 대해 사용되는 경우 대체 로캘 유형을 나타내도록 lastOperationStatus 속성이 설정됩니다.

사용자의 현재 운영 체제 환경 설정에 따라 서식을 지정하려면 requestedLocaleIDName 매개 변수에서 LocaleID.DEFAULT 값을 생성자에 전달합니다.

생성자가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

요청된 로캘 ID 이름이 지원되지 않으면 lastOperationStatus가 다음 중 하나로 설정됩니다.

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

위에 나열된 경고 및 lastOperationStatus 속성의 다른 가능한 값에 대한 자세한 내용은 LastOperationStatus 클래스의 설명을 참조하십시오.

관련 API 요소

Date 객체의 표시 문자열 서식을 지정합니다. 이 문자열은 date, day, fullYear, hours, minutes, month, seconds 등과 같은 Date 객체의 로컬 시간 구성 요소를 사용하여 사용자의 로컬 시간으로 해석됩니다. 로캘 ID 규칙 및 날짜 스타일과 시간 스타일 또는 이 DateTimeFormatter 인스턴스에 대해 지정된 사용자 정의 날짜 패턴과 시간 패턴을 사용하여 서식이 지정됩니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

매개 변수

관련 API 요소

Date 객체의 표시 문자열 서식을 지정합니다. 이 문자열은 dateStyle, timeStyle 또는 날짜 시간 패턴에 따라 dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC, secondsUTC와 같은 Date 객체의 UTC 구성 요소를 사용하여 UTC 시간으로 해석됩니다. 로캘 ID 규칙 및 날짜 스타일과 시간 스타일 또는 이 DateTimeFormatter 인스턴스에 대해 지정된 사용자 정의 날짜 패턴과 시간 패턴을 사용하여 서식이 지정됩니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

매개 변수

관련 API 요소

이 클래스에서 지원되는 로캘 ID 이름을 모두 나열합니다.

이 클래스가 현재 운영 체제에서 지원되지 않는 경우 이 메서드는 null 값을 반환합니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

관련 API 요소

DateTimeFormatter의 이 인스턴스에 대한 날짜 스타일을 가져옵니다. 운영 체제에서 미리 정의된 날짜 서식 패턴을 검색하는 데 사용되는 날짜 스타일입니다. 날짜 스타일 값은 DateTimeFormatter() 생성자, setDateTimeStyles() 메서드 또는 setDateTimePattern() 메서드에서 설정할 수 있습니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

관련 API 요소

이 DateTimeFormatter 객체에서 날짜 및 시간 서식을 지정하기 위해 사용되는 패턴 문자열을 반환합니다.

이 패턴은 다음 세 가지 방법 중 하나로 설정할 수 있습니다.

1. 생성자에 사용된 dateStyle 및 timeStyle 매개 변수 사용
2. setDateTimeStyles() 메서드 사용
3. setDateTimePattern() 메서드 사용

패턴 구문에 대한 설명은 setDateTimePattern() 메서드를 참조하십시오.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

관련 API 요소

이 로캘 및 달력 시스템의 첫 번째 요일에 해당하는 정수를 반환합니다. 0은 일요일에 해당되고 1은 월요일에 해당되는 방식으로 0에서 6까지의 숫자가 일요일에서 토요일까지 해당됩니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

관련 API 요소

현재 달력 시스템의 월 이름을 포함하는 지역화된 문자열 목록을 반환합니다. 목록에서 첫 번째 요소는 해당 연도의 첫 번째 월의 이름입니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

매개 변수

관련 API 요소

DateTimeFormatter의 이 인스턴스에 대한 시간 스타일을 가져옵니다. 운영 체제에서 미리 정의된 시간 서식 패턴을 검색하는 데 사용되는 시간 스타일입니다. 시간 스타일 값은 DateTimeFormatter() 생성자, setDateTimeStyles() 메서드 또는 setDateTimePattern() 메서드에서 설정할 수 있습니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

관련 API 요소

현재 달력 시스템의 요일 이름을 포함하는 지역화된 문자열 목록을 반환합니다. 목록에서 첫 번째 요소는 일요일의 이름을 나타냅니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

매개 변수

관련 API 요소

이 DateTimeFormatter 객체에서 날짜 및 시간 서식을 지정하기 위해 사용되는 패턴 문자열을 설정합니다.

날짜 서식을 지정하는 데 사용되는 패턴은 다음 세 가지 방법 중 하나로 설정할 수 있습니다.

1. 생성자에 사용된 dateStyle 및 timeStyle 매개 변수 사용
2. setDateTimeStyles() 메서드 사용
3. 이 setDateTimePattern() 메서드 사용

이 메서드를 사용하면 이DateTimeFormatter 객체의 현재 시간 및 날짜 스타일이 재정의되고 DateTimeStyle.CUSTOM 값으로 설정될 수도 있습니다.

패턴 문자열은 날짜 및 시간 서식이 지정되는 방식을 정의합니다. 패턴에는 서식이 지정된 문자열에서 날짜 및 시간 값으로 대체되는 글자 시퀀스가 포함됩니다. 예를 들어 "yyyy/MM" 패턴에서 "yyyy" 문자는 4자리 연도로 대체되고 "/" 문자가 뒤에 표시된 다음 "MM"은 2자리 월로 대체됩니다.

패턴에 사용되는 글자는 대부분 여러 번 반복하여 아래 표에 설명된 것처럼 여러 가지 출력을 생성할 수 있습니다.

시퀀스가 패턴에서 지원되는 최대 글자 수를 초과하는 경우 해당 패턴 글자에 대해 지원되는 최대 길이의 시퀀스로 매핑됩니다. 예를 들면 다음과 같습니다.

• MMMMMM는 MMMM으로 대체됩니다.
• dddd는 dd로 대체됩니다.
• EEEEEEE는 EEEE로 대체됩니다.
• aa는 a로 대체됩니다.
• hhh는 hh로 대체됩니다.
• mmmm은 mm으로 대체됩니다.

이론적으로는 패턴에 최대 255자를 포함할 수 있지만 일부 플랫폼에는 좀 더 엄격한 제한이 있습니다. 패턴이 패턴 문자 제한을 초과하면 lastOperationStatus 속성이 LastOperationStatus.PATTERN_SYNTAX_ERROR 값으로 설정됩니다.

운영 체제별로 지원되는 패턴이 다를 수 있습니다. 특정 패턴이 해당 플랫폼에서 지원되지 않으면 대체 패턴이 사용되고 대체 패턴의 사용을 나타내도록 lastOperationStatus 속성이 설정됩니다. 적절한 대체 패턴을 제공할 수 없으면 빈 문자열이 사용되고 해당 패턴이 지원되지 않았음을 나타내도록 lastOperationStatus 속성이 설정됩니다.

다음 표에는 유효한 패턴 문자와 의미가 나와 있습니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

매개 변수

관련 API 요소

DateTimeFormatter의 이 인스턴스에 대한 날짜 및 시간 스타일을 설정합니다. 날짜 및 시간 스타일은 날짜 및 시간 서식 패턴을 운영 체제에서 미리 정의된 로캘 종속 패턴으로 설정하는 데 사용됩니다. 이 메서드는 DateTimeFormatter() 생성자를 사용하거나 setDateTimePattern() 메서드를 사용하여 설정한 스타일을 대체합니다. 날짜 및 시간 패턴도 설정된 스타일에 따라 업데이트됩니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

매개 변수

관련 API 요소

이 예제에 사용되는 로캘은 영어(미국), 프랑스어(프랑스), 스페인어(스페인)입니다.

이 예제에서는 목록의 각 로캘에 대해 다음 작업을 수행합니다.

1. 기본 스타일(확장형 dateStyle, 확장형 timeStyle)을 사용하여 DateTimeFormatter 객체를 만듭니다.
2. 기본 확장형 날짜 스타일을 사용하여 현재 날짜 및 시간 서식을 지정합니다.
3. DateTimeStyle.NONE 및 DateTimeStyle.SHORT 상수를 사용하여 시간 전용 축약형 날짜 스타일로 변경합니다.
4. 시간 전용 축약형 날짜 스타일을 사용하여 현재 날짜 및 시간 서식을 지정합니다.

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() + ")");
            }        
        }
    }
}

이 예제에서는 목록의 각 로캘에 대해 다음 작업을 수행합니다.

1. 세 개의 입력 및 출력 텍스트 필드를 만듭니다.
2. 미국 영어 로켈을 사용하여 DateTimeFormatter 객체를 만듭니다.
3. 텍스트 필드의 위치와 크기를 설정하고 patternField 객체에 이벤트 리스너를 추가하는 configureTextField() 함수를 호출합니다.
4. 사용자가 patternField 텍스트 필드에 패턴을 입력하면 textInputHandler 함수가 이 패턴을 사용하여 현재 날짜 및 시간의 서식을 지정하고 결과와 lastOperationStatus 값을 출력 텍스트 필드에 표시합니다.

 
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();    
        }
    }
}