패키지 | flash.globalization |
클래스 | public final class CurrencyFormatter |
상속 | CurrencyFormatter Object |
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
CurrencyFormatter 클래스는 운영 체제에서 제공된 데이터와 기능을 사용하며, 특정 로캘의 규칙 및 통화 유형에 따라 통화 값 서식을 지정하도록 설계되었습니다. 숫자 서식 내에서 통화 기호, 음수 기호, 소수 구분 기호, 그룹화 구분 기호, 그룹화 패턴 및 기타 요소의 위치는 로캘에 따라 다를 수 있습니다.
요청된 로캘이 운영 체제에서 지원되면 통화 유형이 요청된 로캘의 규칙과 기본값에 따라 설정됩니다. 요청된 로캘이 지원되지 않으면 actualLocaleIDName
속성을 사용하여 검색할 수 있는 기본 시스템 로캘이나 대체 로캘에 따라 해당 속성이 설정됩니다.
요청된 로캘이 지원되지 않을 경우 사용자 설정, 운영 체제에서 제공된 서식 패턴 및 대체 로캘이 사용되기 때문에 같은 로캘 ID를 사용하는 경우에도 사용자에 따라 서식 결과가 다르게 표시될 수 있습니다.
속성 | 정의 주체 | ||
---|---|---|---|
actualLocaleIDName : String [읽기 전용]
이 CurrencyFormatter 객체에서 사용되는 실제 로캘 ID의 이름입니다. | CurrencyFormatter | ||
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
currencyISOCode : String [읽기 전용]
사용되는 실제 로캘의 세 문자로 구성된 ISO 4217 통화 코드입니다. | CurrencyFormatter | ||
currencySymbol : String [읽기 전용]
사용되는 실제 로캘의 통화 기호 또는 문자열입니다. | CurrencyFormatter | ||
decimalSeparator : String
소수 부분이 있는 통화 금액의 서식 지정이나 파싱에 사용되는 소수 구분 기호 문자입니다. | CurrencyFormatter | ||
digitsType : uint
통화 금액 서식을 지정할 때 사용된 숫자 문자 집합을 정의합니다. | CurrencyFormatter | ||
fractionalDigits : int
소수 구분 기호 뒤에 나타날 수 있는 최대 자릿수입니다. | CurrencyFormatter | ||
groupingPattern : String
서식이 지정된 통화 금액 문자열 내에서 그룹화 구분 기호의 위치를 설명합니다. | CurrencyFormatter | ||
groupingSeparator : String
그룹화 구분 기호에 사용되는 문자 또는 문자열입니다. | CurrencyFormatter | ||
lastOperationStatus : String [읽기 전용]
이 CurrencyFormatter에서 수행한 가장 최근 작업의 상태입니다. | CurrencyFormatter | ||
leadingZero : Boolean
소수 구분 기호 왼쪽으로 정수가 없는 경우 서식이 지정된 통화 금액에 선행 0을 포함할지 여부를 지정합니다. | CurrencyFormatter | ||
negativeCurrencyFormat : uint
음수 통화 금액의 서식 패턴을 나타내는 숫자 값입니다. | CurrencyFormatter | ||
negativeSymbol : String
음수 통화 금액 서식을 지정할 때 사용되는 음수 기호입니다. | CurrencyFormatter | ||
positiveCurrencyFormat : uint
양수 통화 금액의 서식 지정 패턴을 나타내는 숫자 값입니다. | CurrencyFormatter | ||
requestedLocaleIDName : String [읽기 전용]
이 CurrencyFormatter 객체의 생성자에 전달된 요청된 로캘 ID의 이름입니다. | CurrencyFormatter | ||
trailingZeros : Boolean
서식이 지정된 통화 금액에 후행 0을 포함할지 여부를 지정합니다. | CurrencyFormatter | ||
useGrouping : Boolean
통화 금액 서식을 지정할 때 그룹화 구분 기호를 사용할 수 있도록 합니다. | CurrencyFormatter |
메서드 | 정의 주체 | ||
---|---|---|---|
CurrencyFormatter(requestedLocaleIDName:String)
지정된 로캘의 규칙에 따라 통화 금액을 나타내는 숫자의 서식을 지정하는 새 CurrencyFormatter 객체를 생성합니다. | CurrencyFormatter | ||
이 CurrencyFormatter 객체의 현재 속성(로캘, 통화 기호 및 통화 ISO 코드 등)에 따라 서식 지정된 통화 금액을 나타내는 문자열을 만듭니다. | CurrencyFormatter | ||
현재 지정된 통화 기호를 사용하여 통화 금액 서식을 지정할 수 있는지 여부를 결정합니다. | CurrencyFormatter | ||
[정적]
이 클래스에서 지원되는 로캘 ID 이름을 모두 나열합니다. | CurrencyFormatter | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
문자열을 통화 금액 및 통화 기호로 파싱합니다. | CurrencyFormatter | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
CurrencyFormatter 객체의 currencyISOCode 및 currencySymbol 속성을 설정합니다. | CurrencyFormatter | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object |
actualLocaleIDName | 속성 |
actualLocaleIDName:String
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
이 CurrencyFormatter 객체에서 사용되는 실제 로캘 ID의 이름입니다.
운영 체제와 CurrencyFormatter()
생성자에 전달된 requestedLocaleIDName
매개 변수의 값에 따라 세 가지 이름 값이 가능합니다.
- 요청된 로캘이
LocaleID.DEFAULT
가 아니고 운영 체제에서 요청된 로캘을 지원하는 경우requestedLocaleIDName
속성과 같은 이름이 반환됩니다. LocaleID.DEFAULT
가 생성자에 전달되는requestedLocaleIDName
매개 변수의 값으로 사용된 경우 사용자의 운영 체제에서 지정된 현재 로캘의 이름이 사용됩니다.LocaleID.DEFAULT
값은 OS의 사용자 정의된 설정을 유지합니다.requestedLocaleIDName
매개 변수로 명시적 값을 전달하면 두 로캘 ID 이름이 같아도LocaleID.DEFAULT
를 사용할 때의 결과와 달라질 수 있습니다. 사용자가 컴퓨터에 로캘 설정을 사용자 정의했을 경우LocaleID.DEFAULT
를 사용하는 대신 명시적 로캘 ID 이름을 요청하면 응용 프로그램에서 사용자 정의된 설정을 검색하지 못합니다.- 운영 체제가 생성자에 지정된
requestedLocaleIDName
을 지원하지 않는 경우 대체 로캘 ID 이름이 제공됩니다.
구현
public function get actualLocaleIDName():String
관련 API 요소
currencyISOCode | 속성 |
currencyISOCode:String
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
사용되는 실제 로캘의 세 문자로 구성된 ISO 4217 통화 코드입니다.
이 코드는 withCurrencySymbol
매개 변수가 false
로 설정된 상태에서 format()
메서드를 사용할 경우 통화 금액 서식을 지정할 때 통화 기호 또는 문자열을 결정하는 데 사용됩니다.
이 속성은 사용되는 실제 로캘에 따른 생성자를 통해 초기화됩니다. 대체 로캘이 사용되는 경우 이 속성은 해당 로캘의 선호되는 기본 통화 코드를 반영합니다.
기본값: dependent on the actual locale and operating system.
구현
public function get currencyISOCode():String
관련 API 요소
currencySymbol | 속성 |
currencySymbol:String
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
사용되는 실제 로캘의 통화 기호 또는 문자열입니다.
이 속성은 withCurrencySymbol
매개 변수가 true
로 설정된 상태에서 format()
메서드를 사용할 경우 통화 금액 서식을 지정할 때 통화 기호로 사용됩니다.
이 속성은 사용되는 실제 로캘에 따른 생성자를 통해 초기화됩니다. 대체 로캘이 사용되는 경우 이 속성은 해당 로캘의 선호되는 기본 통화 기호를 반영합니다.
기본값: dependent on the actual locale and operating system.
구현
public function get currencySymbol():String
관련 API 요소
decimalSeparator | 속성 |
decimalSeparator:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
소수 부분이 있는 통화 금액의 서식 지정이나 파싱에 사용되는 소수 구분 기호 문자입니다.
이 속성은 포맷터 객체가 생성될 때 선택된 로캘을 기반으로 처음에 설정됩니다.
이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
기본값: dependent on the actual locale and operating system.
구현
public function get decimalSeparator():String
public function set decimalSeparator(value:String):void
오류
TypeError — 이 속성에 null 값이 할당된 경우
|
관련 API 요소
digitsType | 속성 |
digitsType:uint
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
통화 금액 서식을 지정할 때 사용된 숫자 문자 집합을 정의합니다.
언어 및 지역별로 0 - 9의 숫자를 나타내는 데 서로 다른 문자 집합이 사용됩니다. 이 속성은 사용될 숫자 집합을 정의합니다.
이 속성의 값은 10진수 집합에서 숫자 0의 유니코드 값을 나타냅니다. 이 속성의 유효한 값은 NationalDigitsType 클래스에 정의됩니다.
이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
기본값: dependent on the actual locale and operating system.
구현
public function get digitsType():uint
public function set digitsType(value:uint):void
오류
TypeError — 이 속성에 null 값이 할당된 경우
|
관련 API 요소
fractionalDigits | 속성 |
fractionalDigits:int
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
소수 구분 기호 뒤에 나타날 수 있는 최대 자릿수입니다.
이 속성에서 지정된 자릿수로 반올림되는 숫자입니다. 반올림 체계는 사용자의 운영 체제에 따라 달라집니다.
trailingZeros
속성이 true
로 설정되면 숫자의 소수점 이하 소수 부분의 길이가 이 fractionalDigits
속성의 값과 일치할 때까지 후행 0으로 채워집니다.
이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
기본값: 0.
구현
public function get fractionalDigits():int
public function set fractionalDigits(value:int):void
관련 API 요소
groupingPattern | 속성 |
groupingPattern:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
서식이 지정된 통화 금액 문자열 내에서 그룹화 구분 기호의 위치를 설명합니다.
useGrouping
속성이 true로 설정되면 그룹화 구분 기호에 사용되는 위치 및 패턴을 정의하는 데 groupingPattern
속성이 사용됩니다.
그룹화 패턴이 세미콜론으로 구분된 숫자를 포함하는 문자열로 정의되고 필요에 따라 별표로 끝날 수 있습니다. 예: "3;2;*"
문자열의 각 숫자는 그룹의 자릿수를 나타냅니다. 그룹화 구분 기호는 각 자릿수 그룹 앞에 위치합니다. 문자열 끝의 별표는 해당 자릿수의 그룹이 서식 지정된 문자열의 나머지에서 반복되어야 함을 나타냅니다. 별표가 없는 경우에는 서식이 지정된 문자열의 나머지에서 추가 그룹 또는 구분 기호가 없음을 의미합니다.
문자열의 첫 번째 숫자는 소수 구분 기호 왼쪽으로 첫 번째 자릿수 그룹에 해당됩니다. 이후의 숫자는 왼쪽으로 다음 그룹의 자릿수를 정의합니다. 따라서 "3;2;*"는 그룹화 구분 기호가 첫 번째 3자리 그룹 뒤에 있고 다음에 2자리 그룹이 있음을 나타냅니다. 예: 98,76,54,321
다음 표에서는 다양한 그룹화 패턴을 사용하여 통화 금액 123456789.12를 서식 지정하는 예를 보여 줍니다. 그룹화 구분 기호는 쉼표이고 소수 구분 기호는 마침표이며 통화 기호는 달러 기호($)입니다.
그룹화 패턴 | 예제 서식 |
3;* | $123,456,789.12 |
3;2;* | $12,34,56,789.12 |
3 | $123456,789.12 |
제한된 개수의 그룹화만 정의할 수 있습니다. 운영 체제에 따라 그룹화 패턴에 숫자 2개와 별표만 포함할 수도 있고, 최대 4개의 숫자와 별표를 지원할 수도 있습니다. 별표가 없는 패턴의 경우 운영 체제별로 하나의 숫자만 지원하거나 최대 3개의 숫자를 지원할 수 있습니다. 그룹화 패턴 요소의 최대 수를 초과하는 경우 추가 요소가 무시되고 lastOperationStatus
속성이 아래에 설명된 대로 설정됩니다.
이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
구현
public function get groupingPattern():String
public function set groupingPattern(value:String):void
오류
TypeError — 이 속성에 null 값이 할당된 경우
|
관련 API 요소
groupingSeparator | 속성 |
groupingSeparator:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
그룹화 구분 기호에 사용되는 문자 또는 문자열입니다.
useGrouping
속성이 true
로 설정되면 통화 금액 서식을 지정할 때 이 속성의 값이 그룹화 구분 기호로 사용됩니다. 이 속성은 포맷터 객체가 생성될 때 선택된 로캘을 기반으로 처음에 설정됩니다.
이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
기본값: dependent on the actual locale and operating system.
구현
public function get groupingSeparator():String
public function set groupingSeparator(value:String):void
오류
TypeError — 이 속성에 null 값이 할당된 경우
|
관련 API 요소
lastOperationStatus | 속성 |
leadingZero | 속성 |
leadingZero:Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
소수 구분 기호 왼쪽으로 정수가 없는 경우 서식이 지정된 통화 금액에 선행 0을 포함할지 여부를 지정합니다.
이 속성이 true
로 설정되면 -1.0과 1.0 사이 숫자 값의 서식을 지정하는 경우 소수 구분 기호 왼쪽으로 선행 0이 포함됩니다. 이 속성이 false
로 설정되면 선행 0이 포함되지 않습니다.
예를 들어 통화 금액이 0.321이고 이 속성이 true
로 설정되면 서식이 지정된 문자열에 선행 0이 포함됩니다. 이 속성이 false
로 설정되면 선행 0이 포함되지 않습니다. 이 경우 문자열에는 $.321
과 같이 소수 구분 기호와 소수 자리 숫자만 포함됩니다.
다음 표에는 이 속성의 값과 관련 fractionalDigits
및 trailingZeros
속성을 기반으로 통화 금액 서식을 지정하는 방식의 예가 나와 있습니다.
trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
true | true | 3 | $0.120 | $0.000 |
false | true | 3 | $0.12 | $0 |
true | false | 3 | $.120 | $.000 |
false | false | 3 | $.12 | $0 |
이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
기본값: dependent on the actual locale and operating system.
구현
public function get leadingZero():Boolean
public function set leadingZero(value:Boolean):void
오류
TypeError — 이 속성에 null 값이 할당된 경우
|
관련 API 요소
negativeCurrencyFormat | 속성 |
negativeCurrencyFormat:uint
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
음수 통화 금액의 서식 패턴을 나타내는 숫자 값입니다. 이 패턴은 통화 금액의 숫자 부분과 관련하여 통화 기호 및 음수 기호 또는 괄호의 위치를 정의합니다.
이 속성의 값은 다음 표에 정의된 상수 중 하나여야 합니다.
아래의 표에는 음수 통화 금액에 가능한 서식 코드가 요약되어 있습니다. format()
메서드를 사용하여 통화 금액 서식이 지정되는 경우 다음과 같이 적용됩니다.
- '¤' 기호는
format()
메서드에 전달되는withCurrencySymbol
매개 변수의 값에 따라currencyISOCode
또는currencySymbol
속성의 값으로 대체됩니다. - '-' 문자는
negativeNumberSymbol
속성의 값으로 대체되고 - 'n' 문자는
format()
메서드에 전달되는 통화 금액 값으로 대체됩니다.
음수 통화 서식 유형 | 서식 지정 패턴 |
0 | (¤n) |
1 | -¤n |
2 | ¤-n |
3 | ¤n- |
4 | (n¤) |
5 | -n¤ |
6 | n-¤ |
7 | n¤- |
8 | -n ¤ |
9 | -¤ n |
10 | n ¤- |
11 | ¤ n- |
12 | ¤ -n |
13 | n- ¤ |
14 | (¤ n) |
15 | (n ¤) |
이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
기본값: dependent on the actual locale and operating system.
구현
public function get negativeCurrencyFormat():uint
public function set negativeCurrencyFormat(value:uint):void
오류
ArgumentError — 할당된 값이 0 - 15 사이가 아닌 경우
|
관련 API 요소
negativeSymbol | 속성 |
negativeSymbol:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
음수 통화 금액 서식을 지정할 때 사용되는 음수 기호입니다.
이 기호는 0 미만의 통화 금액의 서식을 지정할 때 음수 통화 서식과 함께 사용되며, 음수 통화 금액이 괄호로 둘러싸인 경우와 같이 음수 기호를 포함하지 않는 음수 통화 서식에는 사용되지 않습니다.
이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
기본값: dependent on the actual locale and operating system.
구현
public function get negativeSymbol():String
public function set negativeSymbol(value:String):void
오류
TypeError — 이 속성에 null 값이 할당된 경우
|
관련 API 요소
positiveCurrencyFormat | 속성 |
positiveCurrencyFormat:uint
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
양수 통화 금액의 서식 지정 패턴을 나타내는 숫자 값입니다. 이 서식은 통화 금액의 숫자 부분과 관련하여 통화 기호의 위치를 정의합니다.
이 속성의 값은 다음 표에 정의된 상수 중 하나여야 합니다.
아래의 표에는 양수 통화 금액에 가능한 서식 코드가 요약되어 있습니다. format()
메서드를 사용하여 통화 금액 서식이 지정되는 경우 다음과 같이 적용됩니다.
- '¤' 기호는
format()
메서드에 전달되는withCurrencySymbol
매개 변수의 값에 따라currencyISOCode
또는currencySymbol
속성의 값으로 대체됩니다. - 'n' 문자는
format()
메서드에 전달되는 통화 금액 값으로 대체됩니다.
양수 통화 서식 유형 | 서식 지정 패턴 |
0 | ¤n |
1 | n¤ |
2 | ¤ n |
3 | n ¤ |
이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
기본값: dependent on the actual locale and operating system.
구현
public function get positiveCurrencyFormat():uint
public function set positiveCurrencyFormat(value:uint):void
오류
ArgumentError — 할당된 값이 0 - 3 사이가 아닌 경우
|
관련 API 요소
requestedLocaleIDName | 속성 |
requestedLocaleIDName:String
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
이 CurrencyFormatter 객체의 생성자에 전달된 요청된 로캘 ID의 이름입니다.
LocaleID.DEFAULT
값이 사용된 경우 "i-default"가 반환됩니다. 대체 로캘이 적용된 경우 사용된 실제 로캘은 요청된 로캘과 다를 수 있습니다. 실제 로캘 이름은 actualLocaleIDName
속성을 사용하여 검색할 수 있습니다.
구현
public function get requestedLocaleIDName():String
관련 API 요소
trailingZeros | 속성 |
trailingZeros:Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
서식이 지정된 통화 금액에 후행 0을 포함할지 여부를 지정합니다.
이 속성이 true
로 설정되면 서식이 지정된 숫자의 소수 부분에 fractionalDigits
속성에 지정한 한도까지 후행 0이 포함됩니다. 이 속성이 false
로 설정되면 후행 0이 표시되지 않습니다.
예를 들어 통화 금액이 123.4이고 이 속성이 true로 설정된 경우 fractionalDigits
속성이 3으로 설정되면 서식이 지정된 문자열에 $123.400
과 같이 후행 0이 표시됩니다. 이 속성이 false
이면 후행 0이 포함되지 않으며 $123.4
와 같이 문자열에 소수 구분 기호와 0이 아닌 소수만 표시됩니다.
다음 표에는 이 속성의 값과 관련 fractionalDigits
및 leadingZero
속성을 기반으로 통화 금액 서식을 지정하는 방식의 예가 나와 있습니다.
trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
true | true | 3 | $0.120 | $0.000 |
false | true | 3 | $0.12 | $0 |
true | false | 3 | $.120 | $.000 |
false | false | 3 | $.12 | $0 |
이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
기본값: dependent on the actual locale and operating system.
구현
public function get trailingZeros():Boolean
public function set trailingZeros(value:Boolean):void
오류
TypeError — 이 속성에 null 값이 할당된 경우
|
관련 API 요소
useGrouping | 속성 |
useGrouping:Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
통화 금액 서식을 지정할 때 그룹화 구분 기호를 사용할 수 있도록 합니다.
useGrouping
속성이 true
로 설정되면 그룹화 구분 기호 문자에 따라 숫자가 그룹화되고 구분됩니다. 예: $123,456,789
useGrouping
속성이 false
로 설정되면 숫자가 그룹화되거나 구분되지 않습니다. 예: $123456789
groupingSeparator
속성은 그룹화 구분 기호로 사용할 기호를 정의합니다. groupingPattern
속성은 그룹화 구분 기호 사이의 자릿수를 정의합니다.
이 속성에 값이 할당되면 오류나 경고가 없을 경우 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
구현
public function get useGrouping():Boolean
public function set useGrouping(value:Boolean):void
관련 API 요소
CurrencyFormatter | () | 생성자 |
public function CurrencyFormatter(requestedLocaleIDName:String)
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
지정된 로캘의 규칙에 따라 통화 금액을 나타내는 숫자의 서식을 지정하는 새 CurrencyFormatter 객체를 생성합니다.
이 생성자는 현재 운영 체제에서 요청된 ID 이름을 지원하는지 여부를 결정합니다. 지원되지 않으면 대체 로캘이 대신 사용됩니다. 대체 로캘이 사용되면 lastOperationStatus
속성에는 대체 로캘의 유형이 나타나고 actualLocaleIDName
속성에는 대체 로캘 ID의 이름이 포함됩니다.
currencySymbol
및 currencyISOCode
속성 같은 특정한 속성이 해당 로캘에 따라 자동으로 설정됩니다.
참고: 대체 로캘이 사용되면 통화 속성이 기본값으로 설정되고 이에 따라 currencySymbol
또는 currencyISOCode
속성에 예상치 않은 값이 지정될 수 있습니다. 따라서 통화 금액 서식을 지정하기 전에 currencySymbol
및 currencyISOCode
속성 값을 검토하는 것이 좋습니다.
사용자의 현재 운영 체제 환경 설정에 따라 서식을 지정하려면 requestedLocaleIDName
매개 변수에서 LocaleID.DEFAULT
값을 생성자에 전달합니다.
생성자가 호출되고 성공적으로 완료되면 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
요청된 로캘 ID 이름이 지원되지 않으면 lastOperationStatus
가 다음 중 하나로 설정됩니다.
LastOperationStatus.USING_FALLBACK_WARNING
LastOperationStatus.USING_DEFAULT_WARNING
또는 lastOperationStatus
속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.
위에 나열된 경고 및 lastOperationStatus
속성의 다른 가능한 값에 대한 자세한 내용은 LastOperationStatus
클래스의 설명을 참조하십시오.
requestedLocaleIDName:String — 날짜 및 시간 서식을 결정할 때 사용할 기본 로캘 ID 이름입니다.
|
오류
TypeError — requestedLocaleIDName 매개 변수가 null 인 경우
|
관련 API 요소
format | () | 메서드 |
public function format(value:Number, withCurrencySymbol:Boolean = false):String
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
이 CurrencyFormatter 객체의 현재 속성(로캘, 통화 기호 및 통화 ISO 코드 등)에 따라 서식 지정된 통화 금액을 나타내는 문자열을 만듭니다.
기본적으로 이 메서드는 currencyISOCode
속성을 통해 서식을 지정할 때 사용되는 통화 기호 및 다른 설정을 결정합니다.
많은 나라 및 지역에서 서로 다른 통화에 같은 통화 기호를 사용합니다. 예를 들어 미국, 오스트레일리아, 뉴질랜드, 캐나다 및 멕시코는 모두 현지 통화 값에 같은 달러 기호($)를 사용합니다. 서식 지정 통화가 사용자의 현지 통화와 다를 경우 통화 문자열로 ISO 코드를 사용하는 것이 가장 좋습니다. formattingWithCurrencySymbolIsSafe()
메서드를 사용하여 서식을 지정할 해당 통화의 ISO 코드가 포맷터의 currencyISOCode
속성과 일치하는지 테스트할 수 있습니다.
이 메서드는 크기가 매우 큰 숫자와 매우 작은 숫자의 서식을 지정할 수 있습니다. 그러나 중요한 자릿수의 개수는 Number 객체 유형에서 제공된 정밀도로 제한됩니다.
매개 변수
value:Number — 통화 문자열로 서식이 지정될 숫자 값입니다.
| |
withCurrencySymbol:Boolean (default = false ) — false로 설정되면 currencyISOCode 속성이 출력 문자열에서 사용할 통화 문자열 또는 기호를 결정합니다. true로 설정되면 currencySymbol 속성의 현재 값이 출력 문자열에서 사용됩니다.
|
String — 서식이 지정된 통화 값을 포함하는 문자열입니다.
|
관련 API 요소
currencyISOCode
formattingWithCurrencySymbolIsSafe()
lastOperationStatus
LastOperationStatus
예제 ( 예제 사용 방법 )
withCurrencySymbol
매개 변수가 true로 설정되면 통화 금액 서식을 지정하는 데 currencySymbol
속성이 사용됩니다.
var cf:CurrencyFormatter = new CurrencyFormatter("fr-CA"); trace(cf.actualLocaleIDName); // "fr-CA" trace(cf.currencyISOCode); // "CAD" trace(cf.currencySymbol); // "$" trace(cf.format(1254.56)); // "1 254,56 CAD" trace(cf.format(1254.56, true)); // "1 254,56 $"
두 번째 예제에서는 기본 사용자 로캘을 사용하여 캐나다 달러로 통화 금액 서식을 지정하는 방법을 보여 줍니다. formattingWithCurrencySymbolIsSafe()
메서드를 통해 사용자의 기본 통화가 캐나다 달러인지 확인하고, 캐나다 달러이면 withCurrencySymbol
매개 변수가 true로 설정되었을 경우 해당 서식 메서드가 사용됩니다. 캐나다 달러가 아니면 좀 더 설명적인 통화 기호를 사용하여 통화가 캐나다 달러로 설정됩니다. 예제에서는 기본 로캘이 프랑스어(캐나다) 또는 영어(미국)였을 경우 통화 서식이 지정되는 방식을 보여 줍니다.
var cf:CurrencyFormatter = new CurrencyFormatter(LocaleID.DEFAULT); if (cf.formattingWithCurrencySymbolIsSafe("CAD")) { trace(cf.actualLocaleIDName); // "fr-CA French (Canada)" trace(cf.format(1254.56, false)); // "1 254,56 $" } else { trace(cf.actualLocaleIDName); // "en-US English (USA)" cf.setCurrency("CAD", "C$") trace(cf.format(1254.56, true)); // "C$ 1,254.56" }
formattingWithCurrencySymbolIsSafe | () | 메서드 |
public function formattingWithCurrencySymbolIsSafe(requestedISOCode:String):Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
현재 지정된 통화 기호를 사용하여 통화 금액 서식을 지정할 수 있는지 여부를 결정합니다.
많은 나라 및 지역에서 서로 같은 통화 기호를 사용합니다. 이 메서드를 사용하면 모호한 통화 기호나, 대체 로캘의 사용으로 인해 예상과 달라진 통화 기호 또는 ISO 코드를 안전하게 사용할 수 있습니다.
이 메서드는 통화 금액이 사용자의 기본 통화로 서식이 지정된 경우 현지 통화 기호를 표시하거나, 통화 금액이 사용자의 기본값과 다른 통화로 서식이 지정된 경우 보다 특정한 ISO 코드 문자열을 표시하는 데 주로 사용됩니다.
이 메서드는 requestedISOCode
매개 변수를 현재 currencyISOCode
속성과 비교하고 문자열이 서로 같을 경우 true
를, 다를 경우 false
를 각각 반환합니다. 문자열이 서로 같을 경우 withCurrencySymbol
매개 변수가 true
로 설정된 상태에서 format()
메서드를 사용하면 해당 로캘의 고유한 통화 기호가 포함된 서식이 지정된 통화 값 문자열이 생성됩니다. 이 메서드가 false를 반환하는 경우 withCurrencySymbol
매개 변수가 true로 설정된 상태에서 format()
메서드를 사용하면 모호하거나 잘못된 통화 기호가 사용될 수 있습니다.
이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
매개 변수
requestedISOCode:String — 세 문자로 구성된 ISO 4217 통화 코드(예: 미국 달러의 경우 USD, 유로의 경우 EUR)입니다. A에서 Z의 대문자 세 개를 포함해야 합니다.
|
Boolean — currencyISOCode 속성이 requestedISOCode 매개 변수와 일치하면 true 이고, 그렇지 않으면 false 입니다.
|
오류
TypeError — requestedISOCode 매개 변수가 null인 경우
|
관련 API 요소
getAvailableLocaleIDNames | () | 메서드 |
public static function getAvailableLocaleIDNames():Vector.<String>
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
이 클래스에서 지원되는 로캘 ID 이름을 모두 나열합니다.
이 클래스가 현재 운영 체제에서 지원되지 않는 경우 이 메서드는 null 값을 반환합니다.
이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
Vector.<String> — 이 클래스에서 지원되는 모든 로캘 ID 이름을 포함하는 문자열 벡터입니다.
|
parse | () | 메서드 |
public function parse(inputString:String):CurrencyParseResult
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
문자열을 통화 금액 및 통화 기호로 파싱합니다.
파싱 알고리즘에서는 decimalSeparator
속성의 값을 사용하여 숫자의 정수 부분과 소수 부분을 결정합니다. 또한 negativeCurrencyFormat
및 positiveCurrencyFormat
속성의 값을 사용하여 통화 금액과 관련된 통화 기호 또는 문자열의 위치를 결정합니다. 음수 값의 경우 negativeCurrencyFormat
속성 값에서 음수 기호의 위치와 괄호를 사용할지 여부를 결정합니다.
입력 문자열에서 통화 기호, 음수 기호 및 숫자의 순서가 negativeCurrencyFormat
및 positiveCurrencyFormat
속성에서 식별된 패턴과 일치하지 않으면 다음과 같이 처리됩니다.
- 반환된 CurrencyParseResult 객체의
value
속성이NaN
으로 설정됩니다. - 반환된 CurrencyParseResult 객체의
currencyString
속성이null
로 설정됩니다. - 파싱이 실패했음을 나타내도록
lastOperationStatus
속성이 설정됩니다.
입력 문자열에 공백 문자가 포함될 수 있으며, 이러한 공백 문자는 파싱하는 동안 무시됩니다.
통화 기호가 없는 경우에도 파싱이 성공할 수 있습니다. 문자열에서 통화 기호에 해당되는 부분에 대해서는 유효성 검사가 수행되지 않습니다. 통화 기호 또는 문자열이 없는 경우 반환된 CurrencyParseResult 객체의 currencyString
속성이 빈 문자열로 설정됩니다.
이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
매개 변수
inputString:String — 파싱할 입력 문자열입니다.
|
CurrencyParseResult — 숫자 값 및 통화 기호 또는 문자열을 포함하는 CurrencyParseResult 객체입니다.
|
오류
TypeError — inputString 매개 변수가 null인 경우
|
관련 API 요소
setCurrency | () | 메서드 |
public function setCurrency(currencyISOCode:String, currencySymbol:String):void
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
CurrencyFormatter 객체의 currencyISOCode
및 currencySymbol
속성을 설정합니다.
이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus
속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 currencyISOCode
및 currencySymbol
속성이 수정되지 않고 lastOperationStatus
속성이 LastOperationStatus
클래스에 정의된 상수 중 하나로 설정됩니다.
매개 변수
currencyISOCode:String — 세 문자로 구성된 ISO 4217 통화 코드(예: 미국 달러의 경우 USD, 유로의 경우 EUR)입니다. A에서 Z의 대문자 세 개를 포함해야 합니다.
| |
currencySymbol:String — 통화 값 서식을 지정하는 데 사용되는 통화 기호 또는 문자열입니다. 빈 문자열일 수 있습니다.
|
오류
TypeError — currencyISOCode 또는 currencySymbol 매개 변수가 null인 경우
|
관련 API 요소
이 예제에서는 다음 로캘을 사용합니다.
- 현재 서식의 기본 운영 체제 로캘(
LocaleID.DEFAULT
) - 일본어(일본)
- 영어(미국)
- 프랑스어(프랑스)
이 예제에서는 목록의 각 로캘에 대해 다음 작업을 수행합니다.
- CurrencyFormatter 객체를 만듭니다.
formattingWithCurrencySymbolIsSafe()
메서드를 사용하여 로캘의 기본 통화가 유로("EUR")인지를 확인하고 그러한 경우 통화 기호를 사용하여 문자열의 서식을 지정합니다. 유로가 아니면 ISO 코드를 사용하여 문자열의 서식을 지정합니다.
package { import flash.display.Sprite; import flash.globalization.CurrencyFormatter; import flash.globalization.LocaleID; public class CurrencyFormatterExample1 extends Sprite { public function CurrencyFormatterExample1():void { var cf:CurrencyFormatter; var amountWithSymbol:String; var amountWithISOCode:String var localeNames:Array = [LocaleID.DEFAULT, "ja-JP", "en-US", "fr-FR"]; for each (var localeName:String in localeNames) { cf = new CurrencyFormatter(localeName); trace('\n' + "LocaleID requested=" + cf.requestedLocaleIDName + "; actual=" + cf.actualLocaleIDName); trace("Last Operation Status: " + cf.lastOperationStatus ); trace("Currency ISO Code: " + cf.currencyISOCode); if (cf.formattingWithCurrencySymbolIsSafe("EUR")) { amountWithSymbol = cf.format(123456789.19, true); trace("Format using Symbol: "+ amountWithSymbol); } else { amountWithISOCode = cf.format(123456789.19); trace("Format using ISO Code: " + amountWithISOCode); } } } } }
이 예제에서는 다음 단계를 수행합니다.
- 영어(미국) 로캘에 대해 CurrencyFormatter 객체를 만듭니다.
parse()
메서드를 사용하여 입력 문자열을 파싱합니다.- 결과 CurrencyParseResult 객체로부터 금액 및 통화 문자열 값을 표시합니다.
package { import flash.display.Sprite; import flash.globalization.CurrencyFormatter; import flash.globalization.CurrencyParseResult; import flash.globalization.LastOperationStatus; import flash.globalization.LocaleID; public class CurrencyFormatterParseExample extends Sprite { public function CurrencyFormatterParseExample() { var cf:CurrencyFormatter = new CurrencyFormatter( "en_US" ); trace("LocaleID requested=" + cf.requestedLocaleIDName + "; actual=" + cf.actualLocaleIDName); trace("Last Operation Status: " + cf.lastOperationStatus ); var inputString:String = "Dollar 123,567,89,0.254"; var result:CurrencyParseResult = cf.parse(inputString); if (cf.lastOperationStatus == LastOperationStatus.NO_ERROR ) { trace("Amount value: " + result.value); trace("Currency string: " + result.currencyString); } } } }
Tue Jun 12 2018, 03:17 PM Z