Referencia de ActionScript® 3.0 para la plataforma de Adobe® Flash®
Inicio  |  Ocultar lista de paquetes y clases |  Paquetes  |  Clases  |  Novedades  |  Índice  |  Apéndices  |  ¿Por qué hay texto en inglés?
Filtros: AIR 30.0 y versiones anteriores, Flash Player 30.0 y versiones anteriores, Flash Lite 4
Flex 4.6 y versiones anteriores, Flash Pro CS6 y versiones anteriores
Ocultar filtros
flash.globalization 

CurrencyFormatter  - AS3

Paquetesx

Nivel superior
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

Elementos del lenguaje

Constantes globales
Funciones globales
Operadores
Sentencias, palabras clave y directivas
Tipos especiales

Apéndices

Novedades
Errores del compilador
Advertencias del compilador
Errores en tiempo de ejecución
Migración a ActionScript 3
Conjuntos de caracteres admitidos
Solo etiquetas MXML
Elementos Motion XML
Etiquetas de texto temporizado
Lista de elementos desfasados
Constantes de implementación de accesibilidad
Cómo utilizar ejemplos de ActionScript
Avisos legales
Paqueteflash.globalization
Clasepublic final class CurrencyFormatter
HerenciaCurrencyFormatter Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

La clase CurrencyFormatter proporciona formato de configuración regional que distinga entre mayúsculas y minúsculas y análisis de valores de divisa.

La clase CurrencyFormatter utiliza los datos y la funcionalidad proporcionada por el sistema operativo y está diseñado para formato a valores de divisa en función de las convenciones de una configuración regional específica y el tipo de divisa. La posición del símbolo de divisa, el símbolo negativo, el separador decimal, la separador de agrupación, el separador decimal del patrón de agrupación y otros elementos puede variar según la configuración regional.

Si el sistema operativo admite la configuración regional solicitada, las propiedades y el tipo de divisa se establecen de acuerdo con las convenciones y los valores predeterminados de la configuración regional. Si la configuración regional requerida no está disponible, se establecen las propiedades de repuesto o según una configuración regional predeterminada del sistema, que se puede recuperar mediante la propiedad actualLocaleIDName.

Debido al uso de la configuración del usuario, al uso de patrones de formato proporcionados por el sistema operativo y al uso de una configuración regional de repuesto cuando la configuración regional requerida no se admite, los usuarios puedan ver diferentes resultados de formato, incluso cuando se utiliza el mismo ID de configuración regional.

Ver los ejemplos



Propiedades públicas
 PropiedadDefinido por
  actualLocaleIDName : String
[solo lectura] El nombre del ID real de configuración regional utilizado por este objeto CurrencyFormatter.
CurrencyFormatter
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  currencyISOCode : String
[solo lectura] El código ISO 4217 de divisa de tres letras para la configuración regional real que se utiliza.
CurrencyFormatter
  currencySymbol : String
[solo lectura] El símbolo o cadena de divisa para la configuración regional real que se utiliza.
CurrencyFormatter
  decimalSeparator : String
El carácter de separador decimal se utiliza para aplicar formato o analizar cantidades de divisa con parte decimal.
CurrencyFormatter
  digitsType : uint
Define el conjunto de caracteres de dígitos utilizados cuando se aplica formato a cantidades de divisa.
CurrencyFormatter
  fractionalDigits : int
El número máximo de dígitos que pueden aparecer después del separador decimal.
CurrencyFormatter
  groupingPattern : String
Describe la colocación de los separadores de agrupación dentro de la cadena de cantidad de divisa con formato.
CurrencyFormatter
  groupingSeparator : String
El carácter o la cadena utilizado para el separador de agrupación.
CurrencyFormatter
  lastOperationStatus : String
[solo lectura] El estado de la última operación que este objeto CurrencyFormatter ha realizado.
CurrencyFormatter
  leadingZero : Boolean
Especifica si se incluye un cero a la izquierda en una cantidad de divisa con formato cuando no hay dígitos enteros a la izquierda del separador decimal.
CurrencyFormatter
  negativeCurrencyFormat : uint
Un valor numérico que indica un patrón de formato para cantidades de divisa negativas.
CurrencyFormatter
  negativeSymbol : String
El símbolo negativo que utilizado al aplicar formato a cantidades de divisa negativas.
CurrencyFormatter
  positiveCurrencyFormat : uint
Un valor numérico que indica un patrón de formato para cantidades de divisa positivas.
CurrencyFormatter
  requestedLocaleIDName : String
[solo lectura] El nombre del ID de configuración regional requerido que se transfirió al constructor de este objeto CurrencyFormatter.
CurrencyFormatter
  trailingZeros : Boolean
Especifica si se incluyen ceros a la derecha en una cantidad de divisa con formato.
CurrencyFormatter
  useGrouping : Boolean
Permite el uso del separador de agrupación cuando se aplica formato a cantidades de divisa.
CurrencyFormatter
Métodos públicos
 MétodoDefinido por
  
CurrencyFormatter(requestedLocaleIDName:String)
Construye un nuevo objeto CurrencyFormatter para dar formato a números que representan cantidades de divisa según las convenciones de una configuración regional determinada.
CurrencyFormatter
  
format(value:Number, withCurrencySymbol:Boolean = false):String
Crea una cadena que representa una cantidad de divisa con formato según las propiedades actuales de este objeto CurrencyFormatter, incluidas la configuración regional, el símbolo de divisa y el código ISO.
CurrencyFormatter
  
Determina si el símbolo de divisa especificado actualmente puede utilizarse cuando se aplica formato a cantidades de divisa.
CurrencyFormatter
  
[estática] Muestra una lista de todos los nombres de ID de configuración regional admitidos por esta clase.
CurrencyFormatter
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
  
Analiza una cadena en una cantidad de divisa y en un símbolo de divisa.
CurrencyFormatter
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
  
setCurrency(currencyISOCode:String, currencySymbol:String):void
Establece las propiedades currencyISOCode y currencySymbol del objeto CurrencyFormatter.
CurrencyFormatter
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Información sobre propiedades

actualLocaleIDName

propiedad
actualLocaleIDName:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

El nombre del ID real de configuración regional utilizado por este objeto CurrencyFormatter.

Existen tres posibilidades para el valor del nombre, en función del sistema operativo y del valor del parámetro requestedLocaleIDName transferido al constructor CurrencyFormatter().

  1. Si la configuración regional requerida no era LocaleID.DEFAULT y el sistema operativo admite la configuración regional requerida, el nombre devuelto es el mismo que la propiedad requestedLocaleIDName.
  2. Si LocaleID.DEFAULT se ha utilizado como el valor del parámetro requestedLocaleIDName en el constructor, se utiliza el nombre de la configuración regional actual especificado por el sistema operativo del usuario. El valor de LocaleID.DEFAULT conserva la configuración personalizada del usuario en el sistema operativo. Transferir un valor explícito como el parámetro requestedLocaleIDName no necesariamente produce el mismo resultado que utilizar LocaleID.DEFAULT incluso si los dos ID de configuración regional son los mismos. El usuario podría haber personalizado los ajustes de la configuración regional de su equipo y, al solicitar un nombre ID de configuración regional explícito en lugar de utilizar LocaleID.DEFAULT, la aplicación no recuperaría dichos ajustes personalizados.
  3. Si el sistema no admite el nombre de requestedLocaleIDName especificado en el constructor, se proporciona un nombre de ID de configuración regional de repuesto.



Implementación
    public function get actualLocaleIDName():String

Elementos de API relacionados

currencyISOCode

propiedad 
currencyISOCode:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

El código ISO 4217 de divisa de tres letras para la configuración regional real que se utiliza.

Este código se utiliza para determinar el símbolo o cadena de divisa cuando se da formato a cantidades de divisa con el método format() y el parámetro withCurrencySymbol establecido en false.

Esta propiedad se inicializa mediante el constructor según la configuración regional real que se utiliza. Cuando se utiliza una configuración regional de repuesto, esta propiedad refleja el código de divisa predeterminado preferido para la configuración regional de repuesto.

El valor predeterminado es dependent on the actual locale and operating system.



Implementación
    public function get currencyISOCode():String

Elementos de API relacionados

currencySymbol

propiedad 
currencySymbol:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

El símbolo o cadena de divisa para la configuración regional real que se utiliza.

Esta propiedad se utiliza como símbolo de divisa cuando se da formato a cantidades de divisa con el método format() y el parámetro withCurrencySymbol establecido en true.

Esta propiedad se inicializa mediante el constructor según la configuración regional real que se utiliza. Cuando se utiliza una configuración regional de repuesto, esta propiedad reflejará el código de divisa predeterminado preferido para la configuración regional de repuesto.

El valor predeterminado es dependent on the actual locale and operating system.



Implementación
    public function get currencySymbol():String

Elementos de API relacionados

decimalSeparator

propiedad 
decimalSeparator:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

El carácter de separador decimal se utiliza para aplicar formato o analizar cantidades de divisa con parte decimal.

Esta propiedad está definida inicialmente según la configuración regional que esté seleccionada cuando se construye el objeto formateador.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the actual locale and operating system.



Implementación
    public function get decimalSeparator():String
    public function set decimalSeparator(value:String):void

Emite
TypeError — si se asigna un valor null a esta propiedad.

Elementos de API relacionados

digitsType

propiedad 
digitsType:uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Define el conjunto de caracteres de dígitos utilizados cuando se aplica formato a cantidades de divisa.

Los distintos idiomas y regiones utilizan conjuntos de caracteres diferentes para representar los dígitos del 0 al 9. Esta propiedad define el conjunto de dígitos que se va a utilizar.

El valor de esta propiedad representa el valor Unicode para el dígito cero de un conjunto de dígitos decimales. Los valores válidos de esta propiedad se definen en la clase NationalDigitsType.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the actual locale and operating system.



Implementación
    public function get digitsType():uint
    public function set digitsType(value:uint):void

Emite
TypeError — si se asigna un valor null a esta propiedad.

Elementos de API relacionados

fractionalDigits

propiedad 
fractionalDigits:int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

El número máximo de dígitos que pueden aparecer después del separador decimal.

Los números se redondean al número de dígitos especificado en esta propiedad. El esquema de redondeo varía en función del sistema operativo del usuario.

Cuando la propiedad trailingZeros se establece en true, la parte fraccionaria del número (después de la coma decimal) se rellena con ceros hasta que su longitud coincida con el valor de esta propiedad fractionalDigits.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es 0.



Implementación
    public function get fractionalDigits():int
    public function set fractionalDigits(value:int):void

Elementos de API relacionados

groupingPattern

propiedad 
groupingPattern:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Describe la colocación de los separadores de agrupación dentro de la cadena de cantidad de divisa con formato.

Cuando la propiedad useGrouping se establece como true, la propiedad groupingPattern se utiliza para definir la ubicación y el patrón utilizados para el separador de agrupación.

El patrón de agrupación se define como una cadena que contiene los números separados por puntos y comas y, opcionalmente, pueden terminar con un asterisco. Por ejemplo: "3;2;*". Cada número de la cadena representa el número de dígitos de un grupo. El separador de agrupación se coloca antes de cada grupo de dígitos. Un asterisco al final de la cadena indica que los grupos con ese número de dígitos se deben repetir para el resto de la cadena con formato. Si no hay asterisco, no hay grupos ni separadores adicionales para el resto de la cadena con formato.

El primer número de la cadena corresponde al primer grupo de dígitos a la izquierda del separador decimal. Los siguientes números definen el número de dígitos de los grupos subsiguientes a la izquierda. Por lo tanto, la cadena "3;2;*" indica que el separador de agrupación se coloca después del primer grupo de 3 dígitos, seguido de grupos de 2 dígitos. Por ejemplo: 98,76,54,321

La tabla siguiente muestra ejemplos de formato de la cantidad de divisa 123456789.12 con varios patrones de agrupación. El separador de agrupación es una coma, el separador decimal es un punto y el símbolo de divisa es un signo dólar ($).

Patrón de agrupaciónFormato de ejemplo
3;* $123,456,789.12
3;2;*$12,34,56,789.12
3$123456,789.12

Sólo se puede definir un número de tamaños de agrupación. En algunos sistemas operativos, los patrones de agrupación solamente puede contener dos números más un asterisco. Otros sistemas operativos admiten hasta cuatro números y un asterisco. Para los patrones sin un asterisco, algunos sistemas operativos sólo admiten un número, mientras que otros admiten hasta tres. Si se supera el número máximo de elementos de patrón de agrupación, los elementos adicionales se pasarán por alto y la propiedad lastOperationStatus se establecerá como se describe a continuación.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.



Implementación
    public function get groupingPattern():String
    public function set groupingPattern(value:String):void

Emite
TypeError — si se asigna un valor null a esta propiedad.

Elementos de API relacionados

groupingSeparator

propiedad 
groupingSeparator:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

El carácter o la cadena utilizado para el separador de agrupación.

El valor de esta propiedad se utiliza como separador de agrupación cuando las cantidades de divisa con formato de la propiedad useGrouping se establecen como true. Esta propiedad está definida inicialmente según la configuración regional que esté seleccionada cuando se construye el objeto formateador.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the actual locale and operating system.



Implementación
    public function get groupingSeparator():String
    public function set groupingSeparator(value:String):void

Emite
TypeError — si se asigna un valor null a esta propiedad.

Elementos de API relacionados

lastOperationStatus

propiedad 
lastOperationStatus:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

El estado de la última operación que este objeto CurrencyFormatter ha realizado. La propiedad lastOperationStatus se establece siempre que se llame al constructor o a un método de esta clase, o si se establece otra propiedad. Para conocer los valores posibles, consulte la descripción de cada método.



Implementación
    public function get lastOperationStatus():String

Elementos de API relacionados

leadingZero

propiedad 
leadingZero:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Especifica si se incluye un cero a la izquierda en una cantidad de divisa con formato cuando no hay dígitos enteros a la izquierda del separador decimal.

Cuando esta propiedad se establece en true, se incluye un cero a la izquierda del separador decimal cuando haya valores numéricos con formato entre -1.0 y 1.0. Si esta propiedad se establece en false no se incluye ningún un cero a la izquierda.

Por ejemplo, si la cantidad de divisa es 0.321 y esta propiedad se establece true, el cero a la izquierda sí se incluye en la cadena con formato. Si la propiedad se establece como false, no se incluye ningún cero a la izquierda. En ese caso, la cadena sólo incluye el separador decimal seguido de los dígitos decimales, es decir, $.321.

La tabla siguiente muestra ejemplos de cómo se aplica formato a cantidades de divisa en función de los valores de esta propiedad y las propiedades fractionalDigits y trailingZeros relacionadas.

trailingZerosleadingZerofractionalDigits0.120
truetrue3$0.120$0.000
falsetrue3$0.12$0
truefalse3$.120$.000
falsefalse3$.12$0

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the actual locale and operating system.



Implementación
    public function get leadingZero():Boolean
    public function set leadingZero(value:Boolean):void

Emite
TypeError — si se asigna un valor null a esta propiedad.

Elementos de API relacionados

negativeCurrencyFormat

propiedad 
negativeCurrencyFormat:uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Un valor numérico que indica un patrón de formato para cantidades de divisa negativas. Este patrón define la ubicación del símbolo de divisa y del símbolo negativo o el paréntesis en relación con la parte numérica de la cantidad de divisa con formato.

El valor de esta propiedad debe ser una de las constantes definidas en la siguiente tabla.

La tabla siguiente resume los patrones de formato posibles para cantidades de divisa negativas. Cuando se aplica formato a una cantidad de divisa con el método format():

  • El símbolo '¤' se sustituye por el valor de la propiedad currencyISOCode o currencySymbol, en función del valor del parámetro withCurrencySymbol transmitido al método format();
  • El carácter '-' se sustituye por el valor de la propiedad negativeNumberSymbol;
  • El carácter 'n' se sustituye por el valor de la cantidad de divisa que se transfiere al método format().
Tipo de formato de divisa negativaPatrón de formato
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 ¤)

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the actual locale and operating system.



Implementación
    public function get negativeCurrencyFormat():uint
    public function set negativeCurrencyFormat(value:uint):void

Emite
ArgumentError — si el valor asignado no está comprendido entre 0 y 15.

Elementos de API relacionados

negativeSymbol

propiedad 
negativeSymbol:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

El símbolo negativo que utilizado al aplicar formato a cantidades de divisa negativas.

Este símbolo se utiliza con el formato de divisa negativa cuando se aplica formato a una cantidad de divisa que es menor que cero. No se utiliza en formatos de divisas negativas que no incluyen un signo negativo (por ejemplo, cuando las cantidades de divisa negativas aparecen entre paréntesis).

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the actual locale and operating system.



Implementación
    public function get negativeSymbol():String
    public function set negativeSymbol(value:String):void

Emite
TypeError — si se asigna un valor null a esta propiedad.

Elementos de API relacionados

positiveCurrencyFormat

propiedad 
positiveCurrencyFormat:uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Un valor numérico que indica un patrón de formato para cantidades de divisa positivas. Este formato define la ubicación del símbolo de divisa relativo a la parte numérica de la cantidad de divisa.

El valor de esta propiedad debe ser una de las constantes definidas en la siguiente tabla.

La tabla siguiente resume los códigos de formato posibles para cantidades de divisa positivas. Cuando se aplica formato a una cantidad de divisa con el método format():

  • El símbolo '¤' se sustituye por el valor de la propiedad currencyISOCode o currencySymbol, en función del valor del parámetro withCurrencySymbol transmitido al método format();
  • El carácter 'n' se sustituye por el valor de la cantidad de divisa que se transfiere al método format().
Tipo de formato de divisa positivaPatrón de formato
0¤n
1
2¤ n
3n ¤

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the actual locale and operating system.



Implementación
    public function get positiveCurrencyFormat():uint
    public function set positiveCurrencyFormat(value:uint):void

Emite
ArgumentError — si el valor asignado no está comprendido entre 0 y 3.

Elementos de API relacionados

requestedLocaleIDName

propiedad 
requestedLocaleIDName:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

El nombre del ID de configuración regional requerido que se transfirió al constructor de este objeto CurrencyFormatter.

Si se ha utilizado el valor LocaleID.DEFAULT, el nombre devuelto es "i-default". La configuración regional real que se utiliza puede ser diferente de la configuración regional requerida cuando cuando se aplica una configuración regional de repuesto. El nombre de la configuración regional real se puede recuperar usando la propiedad actualLocaleIDName.



Implementación
    public function get requestedLocaleIDName():String

Elementos de API relacionados

trailingZeros

propiedad 
trailingZeros:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Especifica si se incluyen ceros a la derecha en una cantidad de divisa con formato.

Cuando esta propiedad se establece en true, se incluyen ceros a la derecha en la parte fraccionaria del número con formato hasta el límite especificado por la propiedad fractionalDigits. Cuando esta propiedad se establece en false, no se muestra ningún cero a la derecha.

Por ejemplo, si la cantidad de divisa es 123.4, esta propiedad se establece en true, y la propiedad fractionalDigits se establece en 3, la cadena con formato mostrará ceros a la derecha, es decir, 123.400 . Si esta propiedad es false, no se incluyen ceros a la derecha y la cadena muestra simplemente el separador decimal seguido de los dígitos decimales sin ceros añadidos, es decir, $123,4 .

La tabla siguiente muestra ejemplos de cómo se aplica formato a cantidades de divisa en función de los valores de esta propiedad y las propiedades fractionalDigits y leadingZero relacionadas.

trailingZerosleadingZerofractionalDigits0.120
truetrue3$0.120$0.000
falsetrue3$0.12$0
truefalse3$.120$.000
falsefalse3$.12$0

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the actual locale and operating system.



Implementación
    public function get trailingZeros():Boolean
    public function set trailingZeros(value:Boolean):void

Emite
TypeError — si se asigna un valor null a esta propiedad.

Elementos de API relacionados

useGrouping

propiedad 
useGrouping:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Permite el uso del separador de agrupación cuando se aplica formato a cantidades de divisa.

Cuando la propiedad useGrouping se establece en true, los dígitos se agrupan y se delimitan mediante el carácter separador de agrupación. Por ejemplo: $123,456,789

Cuando la propiedad useGrouping se establece en false, los dígitos no se agrupan ni se separan. Por ejemplo: $123456789

La propiedad groupingSeparator define el símbolo que se va a utilizar como separador de agrupación. La propiedad groupingPattern define el número de dígitos entre los separadores de agrupación.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.



Implementación
    public function get useGrouping():Boolean
    public function set useGrouping(value:Boolean):void

Elementos de API relacionados

Información sobre constructores

CurrencyFormatter

()Información sobre
public function CurrencyFormatter(requestedLocaleIDName:String)

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Construye un nuevo objeto CurrencyFormatter para dar formato a números que representan cantidades de divisa según las convenciones de una configuración regional determinada.

Este constructor determina si el sistema operativo actual admite el nombre del ID solicitado configuración regional. Si no se admite, se utilizará en su lugar una configuración regional repuesto. Si se utiliza una configuración regional de repuesto, la propiedad lastOperationStatus indica el tipo de repuesto y la propiedad actualLocaleIDName contiene el nombre del ID de configuración regional de repuesto.

Ciertas propiedades currencySymbol y currencyISOCode se definen automáticamente según la configuración regional.

NOTA: cuando se usa una configuración regional de repuesto, las propiedades de divisa se establecen en sus valores predeterminados y, por tanto, las propiedades currencySymbol o currencyISOCode pueden proporcionar valores inesperados. Es una buena idea examinar los valores de las propiedades currencySymbol y currencyISOCode antes de aplicar formato a una cantidad de divisa.

Para dar formato a partir de las preferencias del sistema operativo actuales del usuario, transfiera el valor LocaleID.DEFAULT del parámetro requestedLocaleIDName al constructor.

Cuando se llama al constructor y se completa correctamente, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

Cuando nombre del ID de la configuración regional no está disponible, lastOperationStatus se establece en uno de los valores siguientes:

  • LastOperationStatus.USING_FALLBACK_WARNING
  • LastOperationStatus.USING_DEFAULT_WARNING

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Para obtener información detallada sobre las advertencias que aparecen en la lista anterior y sobre otros valores posibles de la proipedad lastOperationStatus, consulte las descripciones de la clase LastOperationStatus.

Parámetros
requestedLocaleIDName:String — El nombre de ID de configuración regional preferida para utilizar al determinar los formatos de fecha u hora.

Emite
TypeError — Si el parámetro requestedLocaleIDName es null.

Elementos de API relacionados

Información sobre métodos

format

()método
public function format(value:Number, withCurrencySymbol:Boolean = false):String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Crea una cadena que representa una cantidad de divisa con formato según las propiedades actuales de este objeto CurrencyFormatter, incluidas la configuración regional, el símbolo de divisa y el código ISO.

De forma predeterminada, este método utiliza la propiedad currencyISOCode para determinar el símbolo de divisa y otros ajustes durante la aplicación de formato.

Muchos países y regiones utilizan los mismos símbolos de divisa para diferentes monedas. Por ejemplo Estados Unidos, Australia, Nueva Zelanda, Canadá y México utilizan el mismo símbolo de dólar ($) para los valores de divisa local. Cuando el formato de divisa difiere de la divisa local del usuario, es mejor utilizar el código ISO como cadena de divisa. Seguidamente se puede utilizar el método formattingWithCurrencySymbolIsSafe() para probar si el código ISO de la divisa al que se debe dar formato coincide con la propiedad currencyISOCode del formateador.

Este método puede dar formato a números muy grandes y muy pequeños. Sin embargo, el número de dígitos significativos está limitado a la precisión proporcionada por el tipo de datos Number.

Parámetros

value:Number — El valor numérico al que se va a aplicar formato en una cadena de divisa.
 
withCurrencySymbol:Boolean (default = false) — Cuando se establece en false, la propiedad currencyISOCode determina qué cadena o símbolo de divisa se utiliza en la cadena de salida. Cuando se establece como true, se utiliza el valor actual de la propiedad currencySymbol en la cadena de salida.

Valor devuelto
String — Una cadena que contiene el valor de divisa con formato.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En este ejemplo, la configuración regional requerida es fr-CA: francés (Canadá). En el ejemplo se asume que esta configuración regional se admite en el sistema operativo del usuario y, por consiguiente, no se utiliza ninguna configuración regional de repuesto. Para fr-CA, la divisa predeterminada es el dólar canadiense y su código ISO es CAD. Por consiguiente, cuando se alique formato a una divisa con los valores predeterminados, se utiliza CAD como símbolo de divisa. Cuando el parámetro withCurrencySymbol se establece en true, la propiedad currencySymbol se utiliza para dar formato a la cantidad de divisa.
 
         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 $"
         

El segundo ejemplo muestra un método de aplicación de formato a una cantidad de divisa en dólares canadienses utilizando la configuración regional predeterminada del usuario. El método formattingWithCurrencySymbolIsSafe() se utiliza para probar si la divisa predeterminada del usuario es dólares canadienses y, si es así, se utiliza el método format con el parámetro withCurrencySymbol definido como true. En caso contrario, la divisa se establece en dólares canadienses con un símbolo de divisa más descriptivo. El ejemplo muestra cómo se debe aplicar formato a la divisa si la configuración regional predeterminada es francés (Canadá) o inglés (EE.UU.).

 
         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

()método 
public function formattingWithCurrencySymbolIsSafe(requestedISOCode:String):Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Determina si el símbolo de divisa especificado actualmente puede utilizarse cuando se aplica formato a cantidades de divisa.

Muchas regiones y países utilizan los mismos símbolos de divisa. Este método se puede utilizar para evitar el uso de un símbolo de divisa ambiguo, o un símbolo de divisa o código ISO distinto del esperado debido a la utilización de una configuración regional de repuesto.

Un caso de uso común para este método es determinar si debe mostrar un símbolo de divisa local (si se aplica formato a la cantidad en la divisa predeterminada del usuario) o una cadena de código ISO más específica (si se aplica formato la cantidad en una divisa diferente de la predeterminada del usuario).

Este método compara el parámetro requestedISOCode con la propiedad currencyISOCode actual, devolviendo true si las cadenas son iguales y false si no lo son. Cuando las cadenas son iguales, utilizar el método format() con el parámetro withCurrencySymbol establecido en true tiene como resultado una cadena de valor de divisa con formato con un símbolo exclusivo de divisa para la configuración regional. Si este método devuelve false, utilizar format() con el parámetro withCurrencySymbol establecido en true podría provocar el uso de un símbolo de divisa ambiguo o incorrecto.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Parámetros

requestedISOCode:String — Un código ISO 4217 de divisa de tres letras (por ejemplo, USD para dólares dólares, EUR para euros). Debe contener tres letras en mayúsculas entre A y Z.

Valor devuelto
Booleantrue si la propiedad currencyISOCode coincide con el parámetro requestedISOCode; en caso contrario, false.

Emite
TypeError — si el parámetro requestedISOCode es null.

Elementos de API relacionados

getAvailableLocaleIDNames

()método 
public static function getAvailableLocaleIDNames():Vector.<String>

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Muestra una lista de todos los nombres de ID de configuración regional admitidos por esta clase.

Si esta clase no se admite en el sistema operativo actual, este método devuelve un valor null.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Valor devuelto
Vector.<String> — Un vector de cadenas que contiene todos los nombres de ID de configuración regional admitidos por esta clase.

parse

()método 
public function parse(inputString:String):CurrencyParseResult

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Analiza una cadena en una cantidad de divisa y en un símbolo de divisa.

El algoritmo de análisis utiliza el valor de la propiedad decimalSeparator para determinar la parte integral y fraccionaria del número. Utiliza los valores de las propiedades negativeCurrencyFormat y positiveCurrencyFormat para determinar la ubicación del símbolo o la cadena de divisa con relación a la cantidad de divisa. Para valores negativos, el valor de la propiedad negativeCurrencyFormat determina la ubicación del símbolo negativo y si se utilizan paréntesis.

Si el orden del símbolo de divisa, el signo menos y el número de la cadena de entrada no coincide con el patrón identificado por las propiedades negativeCurrencyFormat y positiveCurrencyFormat:

  1. La propiedad value del objeto CurrencyParseResult devuelto se establece como NaN.
  2. La propiedad currencyString del objeto CurrencyParseResult devuelto se establece como null.
  3. La propiedad lastOperationStatus se establece para indicar que ha fallado el análisis.

La cadena de entrada puede incluir caracteres de espacio que se omiten durante el análisis.

El análisis se realizará correctamente incluso si no hay ningún símbolo de divisa. No se lleva a cabo ninguna validación de la parte de la cadena correspondiente al símbolo de divisa. Si no hay símbolo o cadena de divisa, la propiedad currencyString del objeto CurrencyParseResult devuelto se establece en una cadena vacía.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Parámetros

inputString:String — La cadena de entrada que se va a analizar.

Valor devuelto
CurrencyParseResult — Un objeto CurrencyParseResult que contiene el valor numérico y el símbolo o cadena de divisa.

Emite
TypeError — si el parámetro inputString es null.

Elementos de API relacionados

setCurrency

()método 
public function setCurrency(currencyISOCode:String, currencySymbol:String):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Establece las propiedades currencyISOCode y currencySymbol del objeto CurrencyFormatter.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, las propiedades currencyISOCode y currencySymbol no se modifican y la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Parámetros

currencyISOCode:String — El código ISO 4217 de divisa de tres letras (p. ej., USD para dólares dólares, EUR para euros). Debe contener tres letras en mayúsculas entre A y Z.
 
currencySymbol:String — El símbolo o cadena de divisa que se va a utilizar cuando se aplica formato a los valore de divisa. Puede ser una cadena vacía.


Emite
TypeError — Si el parámetro currencyISOCode o currencySymbol es null.

Elementos de API relacionados

CurrencyFormatterExample.as

El ejemplo siguiente, se muestra cómo se da distinto formato a una cantidad de divisa en función de las diferentes configuraciones regionales y divisas. Los resultados de este ejemplo pueden variar en función del sistema operativo y las preferencias del usuario.

Este ejemplo utiliza las siguientes configuraciones regionales:

  • La configuración regional del sistema operativo predeterminado para el formato de divisa (LocaleID.DEFAULT)
  • Japonés (Japón)
  • Inglés (EE.UU.)
  • Francés (Francia)

El ejemplo realiza las acciones siguientes para cada configuración regional de la lista:

  1. Crea un objeto CurrencyFormatter
  2. Utiliza el método formattingWithCurrencySymbolIsSafe() para comprobar si la divisa predeterminada para la configuración regional es euros ("EUR") y si es así, si da formato a la cadena mediante el símbolo de divisa. En caso contrario, aplica formato a la cadena mediante el código 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

El siguiente ejemplo analiza una cantidad de divisa usando las reglas de una configuración regional determinada. Tenga en cuenta que los resultados de este ejemplo pueden variar en función del sistema operativo y las preferencias del usuario.

Este ejemplo lleva a cabo los siguientes pasos:

  1. Crea un objeto CurrencyFormatter para la configuración regional Inglés (EE.UU.).
  2. Utiliza el método parse() para analizar la cadena de entrada.
  3. Muestra los valores de la cadena y la cantidad de divisa del objeto CurrencyParseResult resultante.
 
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 ]¿Por qué hay texto en inglés?
Cierto contenido de la Referencia de ActionScript 3.0 se muestra en inglés

No todo el contenido de la Referencia de ActionScript 3.0 se traduce a todos los idiomas. Si un elemento del lenguaje no se traduce, aparecerá en inglés. Por ejemplo, la clase ga.controls.HelpBox no está traducida en ningún idioma. Por lo tanto, en la versión en español de la referencia, la clase ga.controls.HelpBox aparecerá en inglés.