NumberFormatter  - AS3

이 NumberFormatter 객체에서 사용되는 실제 로캘 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 요소

소수 부분이 있는 숫자의 서식 지정이나 파싱에 사용되는 소수 구분 기호 문자입니다.

이 속성은 포맷터 객체가 생성될 때 선택된 로캘을 기반으로 처음에 설정됩니다.

이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

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

기본값: dependent on the locale and operating system..

관련 API 요소

숫자 서식을 지정할 때 사용된 숫자 문자 집합을 정의합니다.

언어 및 지역별로 0 - 9의 숫자를 나타내는 데 서로 다른 문자 집합이 사용됩니다. 이 속성은 사용될 숫자 집합을 정의합니다.

이 속성의 값은 10진수 집합에서 숫자 0의 유니코드 값을 나타냅니다. 이 속성의 유효한 값은 NationalDigitsType 클래스에 정의됩니다.

이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

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

기본값: dependent on the locale and operating system..

관련 API 요소

소수 구분 기호 뒤에 나타날 수 있는 최대 자릿수입니다.

이 속성에서 지정된 자릿수로 반올림되는 숫자입니다. 반올림 체계는 사용자의 운영 체제에 따라 달라집니다.

trailingZeros 속성이 true로 설정되면 숫자의 소수점 이하 소수 부분의 길이가 이 fractionalDigits 속성의 값과 일치할 때까지 후행 0으로 채워집니다.

이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

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

기본값: 0.

관련 API 요소

서식이 지정된 숫자 문자열 내에서 그룹화 구분 기호의 위치를 설명합니다.

useGrouping 속성이 true로 설정되면 그룹화 구분 기호에 사용되는 위치 및 패턴을 정의하는 데 groupingPattern 속성이 사용됩니다.

그룹화 패턴이 세미콜론으로 구분된 숫자를 포함하는 문자열로 정의되고 필요에 따라 별표로 끝날 수 있습니다. 예: "3;2;*" 문자열의 각 숫자는 그룹의 자릿수를 나타냅니다. 그룹화 구분 기호는 각 자릿수 그룹 앞에 위치합니다. 문자열 끝의 별표는 해당 자릿수의 그룹이 서식 지정된 문자열의 나머지에서 반복되어야 함을 나타냅니다. 별표가 없는 경우에는 서식이 지정된 문자열의 나머지에서 추가 그룹 또는 구분 기호가 없음을 의미합니다.

문자열의 첫 번째 숫자는 소수 구분 기호 왼쪽으로 첫 번째 자릿수 그룹에 해당됩니다. 이후의 숫자는 왼쪽으로 다음 그룹의 자릿수를 정의합니다. 따라서 "3;2;*"는 그룹화 구분 기호가 첫 번째 3자리 그룹 뒤에 있고 다음에 2자리 그룹이 있음을 나타냅니다. 예: 98,76,54,321

다음 표에는 다양한 그룹화 패턴을 사용하여 숫자 123456789.12의 서식을 지정하는 예가 나와 있습니다. 그룹화 구분 기호는 쉼표이고 소수 구분 기호는 마침표입니다.

제한된 개수의 그룹화만 정의할 수 있습니다. 운영 체제에 따라 그룹화 패턴에 숫자 2개와 별표만 포함할 수도 있고, 최대 4개의 숫자와 별표를 지원할 수도 있습니다. 별표가 없는 패턴의 경우 운영 체제별로 하나의 숫자만 지원하거나 최대 3개의 숫자를 지원할 수 있습니다. 그룹화 패턴 요소의 최대 수를 초과하는 경우 추가 요소가 무시되고 lastOperationStatus 속성이 아래에 설명된 대로 설정됩니다.

이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

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

관련 API 요소

그룹화 구분 기호에 사용되는 문자 또는 문자열입니다.

useGrouping 속성이 true로 설정된 숫자 서식을 지정할 때 이 속성의 값이 그룹화 구분 기호로 사용됩니다. 이 속성은 포맷터 객체가 생성될 때 선택된 로캘을 기반으로 처음에 설정됩니다.

이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

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

기본값: dependent on the locale and operating system..

관련 API 요소

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

관련 API 요소

소수 구분 기호 왼쪽으로 정수가 없는 경우 서식이 지정된 숫자에 선행 0을 포함할지 여부를 지정합니다.

이 속성이 true로 설정되면 -1.0과 1.0 사이 숫자 값의 서식을 지정하는 경우 소수 구분 기호 왼쪽으로 선행 0이 포함됩니다. 이 속성이 false로 설정되면 선행 0이 포함되지 않습니다.

예를 들어 숫자가 0.321이고 이 속성이 true로 설정되면 서식이 지정된 문자열에 선행 0이 포함됩니다. 이 속성이 false로 설정되면 선행 0이 포함되지 않습니다. 이 경우 문자열에는 .321과 같이 소수 구분 기호와 소수 자리 숫자만 포함됩니다.

다음 표에는 이 속성의 값과 관련 fractionalDigits 및 trailingZeros 속성을 기반으로 숫자 서식을 지정하는 방식의 예가 나와 있습니다.

이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

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

기본값: dependent on the locale and operating system..

관련 API 요소

음수의 서식 패턴을 나타내는 숫자 값입니다. 이 패턴은 서식이 지정된 숫자의 숫자 부분과 관련하여 음수 기호 또는 괄호의 위치를 정의합니다.

다음 표에는 음수에 사용 가능한 서식이 요약되어 있습니다. 음수에 서식이 지정되면 해당 서식의 빼기 기호가 negativeSymbol 속성의 값으로 대체되고 'n' 문자는 서식이 지정된 숫자 값으로 대체됩니다.

이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

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

기본값: dependent on the locale and operating system..

관련 API 요소

음수 서식을 지정할 때 사용되는 음수 기호입니다.

이 기호는 0 미만의 숫자 서식을 지정할 때 음수 서식과 함께 사용되며, 음수가 괄호로 둘러싸인 경우와 같이 음수 기호를 포함하지 않는 음수 서식에는 사용되지 않습니다.

이 포맷터가 생성되는 경우 이 속성은 선택된 실제 로캘의 기본값으로 설정됩니다. 원하는 값으로 설정하여 기본 설정을 재정의할 수 있습니다.

이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

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

관련 API 요소

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

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

관련 API 요소

서식이 지정된 숫자에 후행 0을 포함할지 여부를 지정합니다.

이 속성이 true로 설정되면 서식이 지정된 숫자의 소수 부분에 fractionalDigits 속성에 지정한 한도까지 후행 0이 포함됩니다. 이 속성이 false로 설정되면 후행 0이 표시되지 않습니다.

예를 들어 숫자 값이 123.4이고 이 속성이 true로 설정된 경우 fractionalDigits 속성이 3으로 설정되면 서식이 지정된 문자열에 123.400과 같이 후행 0이 표시됩니다. 이 속성이 false이면 후행 0이 포함되지 않으며 123.4와 같이 문자열에 소수 구분 기호와 0이 아닌 소수만 표시됩니다.

다음 표에는 이 속성의 값과 관련 fractionalDigits 및 leadingZero 속성을 기반으로 숫자 값 서식을 지정하는 방식의 예가 나와 있습니다.

이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

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

기본값: dependent on the locale and operating system..

관련 API 요소

숫자 서식을 지정할 때 그룹화 구분 기호를 사용할 수 있도록 합니다.

useGrouping 속성이 true로 설정되면 그룹화 구분 기호 문자에 따라 숫자가 그룹화되고 구분됩니다. 예: 123,456,789.22

useGrouping 속성이 false로 설정되면 숫자가 그룹화되거나 구분되지 않습니다. 예: 123456789.22

그룹화 구분 기호로 사용할 기호는 groupingSeparator 속성에서 정의합니다. 그룹화 구분 기호 사이의 자릿수는 groupingPattern 속성에서 정의합니다.

이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

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

관련 API 요소

지정된 로캘의 규칙에 따라 숫자 서식을 지정하는 새 NumberFormatter 객체를 생성합니다.

이 생성자는 현재 운영 체제에서 요청된 ID 이름을 지원하는지 여부를 결정합니다. 지원되지 않으면 대체 로캘이 대신 사용됩니다. 대체 로캘이 사용되면 lastOperationStatus 속성에는 대체 로캘의 유형이 나타나고 actualLocaleIDName 속성에는 대체 로캘 ID의 이름이 포함됩니다.

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

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

• LastOperationStatus.NO_ERROR

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

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

이 클래스가 현재 운영 체제에서 지원되지 않으면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.UNSUPPORTED_ERROR

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

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

관련 API 요소

int 값의 서식을 지정합니다. 이 함수는 int 값을 받는다는 점만 제외하고 formatNumber() 메서드와 동일합니다. 전달된 값이 1.72e308보다 크거나 1.72e-308보다 작은 경우와 같이 너무 크거나 작으면 이 함수에서 0을 반환합니다.

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

• LastOperationStatus.NO_ERROR

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

매개 변수

관련 API 요소

숫자 값의 서식을 지정합니다.

이 함수는 포맷터의 속성 값에 따라 숫자 서식을 지정합니다. numberFormatter 객체가 만들어진 후 속성이 수정되지 않은 경우 숫자는 actualLocaleIDName으로 식별된 로캘에 대해 운영 체제에서 제공하는 로캘 관련 규칙에 따라 서식이 지정됩니다. 서식을 사용자 정의하려면 속성을 변경하여 숫자 서식의 특정한 측면을 제어하면 됩니다.

이 함수를 사용하면 매우 큰 숫자와 매우 작은 크기의 숫자의 서식을 지정할 수 있습니다. 그러나 중요한 자릿수의 개수는 Number 객체에서 제공된 정밀도로 제한됩니다. 공학 표기법은 지원되지 않습니다.

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

• LastOperationStatus.NO_ERROR

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

매개 변수

관련 API 요소

uint 값의 서식을 지정합니다. 이 함수는 uint을 받는다는 점만 제외하고 formatNumber() 메서드와 동일합니다. 전달된 값이 1.72e308보다 큰 값과 같이 너무 크면 이 함수에서 0을 반환합니다.

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

• LastOperationStatus.NO_ERROR

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

매개 변수

관련 API 요소

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

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

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

• LastOperationStatus.NO_ERROR

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

문자열을 파싱하고 파싱된 요소를 포함하는 NumberParseResult 객체를 반환합니다.

NumberParseResult 객체에는 입력 문자열에서 찾은 첫 번째 숫자의 값, 문자열 내 숫자의 시작 인덱스 및 문자열에서 숫자 뒤 첫 번째 문자의 인덱스가 포함됩니다.

문자열에 숫자가 포함되지 않으면 NumberParseResult의 값 속성이 NaN으로 설정되고 startIndex 및 endIndex 속성이 16진수 값 0x7fffffff로 설정됩니다.

이 함수에서는 decimalSeparator 속성의 값을 통해 숫자에서 소수 자리를 포함하는 부분을 결정하고, groupingSeparator 속성을 통해 숫자 자리 내에 문자가 허용되는지 여부를 결정하며, negativeNumberFormat 속성을 통해 음수가 표시되는 방식을 제어합니다.

다음 표에서는 다양한 NegativeNumberFormat 값에 대해 파싱된 문자열 결과를 보여 줍니다.

숫자와 빼기 기호 또는 괄호 사이에는 공백이 하나 허용됩니다.

다른 속성은 유효한 숫자를 결정할 때 무시됩니다. 특히 digitsType 속성의 값이 무시되며 자릿수는 NationalDigitsType 클래스에 열거되는 자릿수 집합에서 파생될 수 있습니다. groupingPattern 및 useGrouping 속성의 값은 숫자 파싱에 영향을 주지 않습니다.

문자열에서 숫자 앞이나 뒤에 더하기 기호 '+'가 있는 경우 더하기 기호는 숫자의 일부가 아닌 문자로 취급됩니다.

공학 표기법이 적용된 숫자(예: 1.23e40)를 포함하는 문자열은 이 함수에서 파싱되지 않습니다.

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

• LastOperationStatus.NO_ERROR

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

매개 변수

관련 API 요소

 
         var nf:NumberFormatter = new NumberFormatter("fr-FR"); 
         var str:String = "1,56 mètre"
         var result:NumberParseResult = nf.parse(str);
         trace(result.value) // 1.56
         trace(str.substr(0,result.startIndex));                // ""
         trace(str.substr(result.startIndex, result.endIndex)); // "1,56"
         trace(str.substr(result.endIndex));                    // " mètre"
         

숫자와 공백 문자(선택적)만 포함된 문자열을 파싱하고 숫자를 반환합니다. 문자열이 숫자로 시작하지 않거나 숫자에 속하지 않는 공백이 아닌 문자를 포함하는 경우 이 메서드는 NaN을 반환합니다. 숫자 앞이나 뒤의 공백은 무시됩니다. 공백 문자는 유니코드 문자 데이터베이스(http://www.unicode.org/ucd/ 참조)의 공백 구분 기호(Z) 속성을 가진 문자입니다.

숫자 앞이나 뒤에 더하기 기호 '+'가 있는 경우 공백이 아닌 문자로 취급됩니다. 반환 값은 NaN입니다.

숫자 파싱 및 유효한 숫자의 구성 요소에 대한 자세한 내용은 parse 함수의 설명을 참조하십시오.

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

• LastOperationStatus.NO_ERROR

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

매개 변수

관련 API 요소

다음 예제에서는 숫자 서식에 운영 체제 기본 로캘이 사용되고 일본어(일본), 영어(미국) 및 프랑스어(프랑스)가 사용됩니다. 이 예제는 정적 멤버 LocaleID.DEFAULT를 사용하여 기본 운영 체제 비헤이비어를 요청합니다.

이 예제의 결과는 운영 체제 및 사용자 환경 설정에 따라 달라질 수 있습니다.

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

1. NumberFormatter 객체를 만듭니다.
2. Number, 정수 및 부호 없는 정수와 동일한 값에 서식을 지정하고 결과를 표시합니다.

 
package {
    import flash.globalization.NumberFormatter;
    import flash.globalization.LocaleID;
    
    public class NumberFormatterExample extends Sprite
    {
        public function NumberFormatterExample():void
        {
            var localeNames:Array = [LocaleID.DEFAULT,"ja_JP","en_US","fr_FR"];
            
            for ( var i:int = 0; i < localeNames.length; i++ ) 
            {
                var nf:NumberFormatter = new NumberFormatter( localeNames[i] as String );
                trace('\n\n' + "LocaleID requested: " + nf.requestedLocaleIDName 
                    + "; actual: " + nf.actualLocaleIDName);
                trace( "Last Operation Status:" + nf.lastOperationStatus );   
            
                var numberString:String = nf.formatNumber(123456789.19); 
                trace( "Formatted Number:" + numberString);
                numberString = nf.formatInt(-123456789); 
                trace( "Formatted Int:" + numberString);
                numberString = nf.formatUint(123456789); 
                trace( "Formatted UInt:" + numberString);
            }
        }
    }
}

이 예제의 결과는 운영 체제 및 사용자 환경 설정에 따라 달라질 수 있습니다.

이 예제에서는 다음을 수행합니다.

1. NumberFormatter 객체를 만듭니다.
2. NumberFormatter.parse() 메서드를 호출하여 문자열을 파싱하고 NumberParseResult 객체를 반환합니다.
3. NumberFormatter.parseNumber() 메서드를 호출하여 파싱하고 Number 값을 반환합니다.

 
package {
      import flash.globalization.NumberFormatter;
      import flash.globalization.NumberParseResult;
      import flash.globalization.LastOperationStatus;
      import flash.globalization.LocaleID;

      public class NumberFormatterParseExample
      {
            public function NumberFormatterParseExample():void
            {
                var nf:NumberFormatter = new NumberFormatter( "en_US" );
                trace("LocaleID requested: " + nf.requestedLocaleIDName 
                    + "; actual: " + nf.actualLocaleIDName);
                trace( "Last Operation Status:" + nf.lastOperationStatus );  

                var inputNumberString:String = "123,567,89,0.254";
                var parseResult:NumberParseResult = nf.parse(inputNumberString);
                if ( nf.lastOperationStatus == LastOperationStatus.NO_ERROR ) {
                    trace("Parsed value:" + parseResult.value);
                }
                inputNumberString = "-123,567,89,0.254";
                var parsedNumber:Number = nf.parseNumber(inputNumberString);
                if ( nf.lastOperationStatus == LastOperationStatus.NO_ERROR ) {
                    trace("Parsed value:" + parsedNumber);
                }
            }
      }
}