Adobe® Flash® Platform용 ActionScript® 3.0 참조 설명서
 |  패키지 및 클래스 목록 숨기기 |  패키지  |  클래스  |  새로운 내용  |  색인  |  부록  |  영어로 표시되는 이유
필터: AIR 30.0 이하, Flash Player 30.0 이하, Flash Lite 4
Flex 4.6 이하, Flash Pro CS6 이하
필터 숨기기
flash.globalization 

CurrencyFormatter  - AS3

패키지x

최상위 레벨
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

언어 요소

전역 상수
전역 함수
연산자
명령문, 키워드 및 지시문
특수 유형 연산자

부록

새로운 내용
컴파일러 오류
컴파일러 경고
런타임 오류
ActionScript 3으로 마이그레이션
지원되는 문자 세트
MXML 전용 태그
모션 XML 요소
Timed Text 태그
사용되지 않는 요소의 목록
액세스 가능성 구현 상수
ActionScript 예제 사용 방법
법적 고지 사항
패키지flash.globalization
클래스public final class CurrencyFormatter
상속CurrencyFormatter Inheritance Object

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10.1, AIR 2

CurrencyFormatter 클래스는 통화 값에 대한 로캘별 서식 지정 및 파싱을 제공합니다.

CurrencyFormatter 클래스는 운영 체제에서 제공된 데이터와 기능을 사용하며, 특정 로캘의 규칙 및 통화 유형에 따라 통화 값 서식을 지정하도록 설계되었습니다. 숫자 서식 내에서 통화 기호, 음수 기호, 소수 구분 기호, 그룹화 구분 기호, 그룹화 패턴 및 기타 요소의 위치는 로캘에 따라 다를 수 있습니다.

요청된 로캘이 운영 체제에서 지원되면 통화 유형이 요청된 로캘의 규칙과 기본값에 따라 설정됩니다. 요청된 로캘이 지원되지 않으면 actualLocaleIDName 속성을 사용하여 검색할 수 있는 기본 시스템 로캘이나 대체 로캘에 따라 해당 속성이 설정됩니다.

요청된 로캘이 지원되지 않을 경우 사용자 설정, 운영 체제에서 제공된 서식 패턴 및 대체 로캘이 사용되기 때문에 같은 로캘 ID를 사용하는 경우에도 사용자에 따라 서식 결과가 다르게 표시될 수 있습니다.

예제 보기



공용 속성
 속성정의 주체
  actualLocaleIDName : String
[읽기 전용] 이 CurrencyFormatter 객체에서 사용되는 실제 로캘 ID의 이름입니다.
CurrencyFormatter
 Inheritedconstructor : 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
  
format(value:Number, withCurrencySymbol:Boolean = false):String
이 CurrencyFormatter 객체의 현재 속성(로캘, 통화 기호 및 통화 ISO 코드 등)에 따라 서식 지정된 통화 금액을 나타내는 문자열을 만듭니다.
CurrencyFormatter
  
현재 지정된 통화 기호를 사용하여 통화 금액 서식을 지정할 수 있는지 여부를 결정합니다.
CurrencyFormatter
  
[정적] 이 클래스에서 지원되는 로캘 ID 이름을 모두 나열합니다.
CurrencyFormatter
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
  
문자열을 통화 금액 및 통화 기호로 파싱합니다.
CurrencyFormatter
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
  
setCurrency(currencyISOCode:String, currencySymbol:String):void
CurrencyFormatter 객체의 currencyISOCode 및 currencySymbol 속성을 설정합니다.
CurrencyFormatter
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
속성 세부 정보

actualLocaleIDName

속성
actualLocaleIDName:String  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10.1, AIR 2

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

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

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

속성 
lastOperationStatus:String  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10.1, AIR 2

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



구현
    public function get lastOperationStatus():String

관련 API 요소

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과 같이 소수 구분 기호와 소수 자리 숫자만 포함됩니다.

다음 표에는 이 속성의 값과 관련 fractionalDigitstrailingZeros 속성을 기반으로 통화 금액 서식을 지정하는 방식의 예가 나와 있습니다.

trailingZerosleadingZerofractionalDigits0.120
truetrue3$0.120$0.000
falsetrue3$0.12$0
truefalse3$.120$.000
falsefalse3$.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¤
6n-¤
7n¤-
8-n ¤
9-¤ n
10n ¤-
11¤ n-
12¤ -n
13n- ¤
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
2¤ n
3n ¤

이 속성에 값이 할당되면 오류나 경고가 없을 경우 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이 아닌 소수만 표시됩니다.

다음 표에는 이 속성의 값과 관련 fractionalDigitsleadingZero 속성을 기반으로 통화 금액 서식을 지정하는 방식의 예가 나와 있습니다.

trailingZerosleadingZerofractionalDigits0.120
truetrue3$0.120$0.000
falsetrue3$0.12$0
truefalse3$.120$.000
falsefalse3$.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의 이름이 포함됩니다.

currencySymbolcurrencyISOCode 속성 같은 특정한 속성이 해당 로캘에 따라 자동으로 설정됩니다.

참고: 대체 로캘이 사용되면 통화 속성이 기본값으로 설정되고 이에 따라 currencySymbol 또는 currencyISOCode 속성에 예상치 않은 값이 지정될 수 있습니다. 따라서 통화 금액 서식을 지정하기 전에 currencySymbolcurrencyISOCode 속성 값을 검토하는 것이 좋습니다.

사용자의 현재 운영 체제 환경 설정에 따라 서식을 지정하려면 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 요소


예제  ( 예제 사용 방법 )
이 예제에서 요청된 로캘은 fr-CA 프랑스어(캐나다)입니다. 예제에서는 이 로캘이 사용자의 운영 체제에서 지원되며, 따라서 대체 로캘이 사용되지 않는다고 가정합니다. fr-CA의 기본 통화는 ISO 코드가 CAD인 캐나다 달러입니다. 따라서 기본 값으로 통화 서식을 지정하면 CAD가 통화 기호로 사용됩니다. 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의 대문자 세 개를 포함해야 합니다.

반환값
BooleancurrencyISOCode 속성이 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 속성의 값을 사용하여 숫자의 정수 부분과 소수 부분을 결정합니다. 또한 negativeCurrencyFormatpositiveCurrencyFormat 속성의 값을 사용하여 통화 금액과 관련된 통화 기호 또는 문자열의 위치를 결정합니다. 음수 값의 경우 negativeCurrencyFormat 속성 값에서 음수 기호의 위치와 괄호를 사용할지 여부를 결정합니다.

입력 문자열에서 통화 기호, 음수 기호 및 숫자의 순서가 negativeCurrencyFormatpositiveCurrencyFormat 속성에서 식별된 패턴과 일치하지 않으면 다음과 같이 처리됩니다.

  1. 반환된 CurrencyParseResult 객체의 value 속성이 NaN으로 설정됩니다.
  2. 반환된 CurrencyParseResult 객체의 currencyString 속성이 null로 설정됩니다.
  3. 파싱이 실패했음을 나타내도록 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 객체의 currencyISOCodecurrencySymbol 속성을 설정합니다.

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

  • LastOperationStatus.NO_ERROR

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

매개 변수

currencyISOCode:String — 세 문자로 구성된 ISO 4217 통화 코드(예: 미국 달러의 경우 USD, 유로의 경우 EUR)입니다. A에서 Z의 대문자 세 개를 포함해야 합니다.
 
currencySymbol:String — 통화 값 서식을 지정하는 데 사용되는 통화 기호 또는 문자열입니다. 빈 문자열일 수 있습니다.


오류
TypeError currencyISOCode 또는 currencySymbol 매개 변수가 null인 경우

관련 API 요소

CurrencyFormatterExample.as

다음에서는 다양한 로캘 및 통화에 따라 통화 금액이 다르게 서식 지정되는 방법을 보여 줍니다. 이 예제의 결과는 운영 체제 및 사용자 환경 설정에 따라 달라질 수 있습니다.

이 예제에서는 다음 로캘을 사용합니다.

  • 현재 서식의 기본 운영 체제 로캘(LocaleID.DEFAULT)
  • 일본어(일본)
  • 영어(미국)
  • 프랑스어(프랑스)

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

  1. CurrencyFormatter 객체를 만듭니다.
  2. 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);
                }
            }
        }
    }
}
CurrencyFormatterParseExample.as

다음 예제에서는 주어진 로캘에 대한 규칙을 사용하여 통화 금액을 파싱합니다. 이 예제의 결과는 운영 체제 및 사용자 환경 설정에 따라 달라질 수 있습니다.

이 예제에서는 다음 단계를 수행합니다.

  1. 영어(미국) 로캘에 대해 CurrencyFormatter 객체를 만듭니다.
  2. parse() 메서드를 사용하여 입력 문자열을 파싱합니다.
  3. 결과 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); 
                }
            }
      }
}




[ X ]영어로 표시되는 이유
ActionScript 3.0 참조 설명서의 내용이 영어로 나타납니다.

ActionScript 3.0 참조 설명서 중 일부는 전체 언어로 번역되지 않았습니다. 언어 요소가 번역되지 않은 경우 영어로 나타납니다. 예를 들어 ga.controls.HelpBox 클래스는 어떤 언어로도 번역되지 않았습니다. 그러므로 한국어 버전의 참조 설명서에서 ga.controls.HelpBox 클래스는 영어로 나타납니다.