Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: AIR 30.0 e versioni precedenti, Flash Player 30.0 e versioni precedenti, Flash Lite 4
Flex 4.6 e versioni precedenti, Flash Pro CS6 e versioni precedenti
Nascondi filtri
flash.globalization 

CurrencyFormatter  - AS3

Pacchettix

Primo livello
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

Elementi del linguaggio

Costanti globali
Funzioni globali
Operatori
Istruzioni, parole chiave e direttive
Tipi speciali

Appendici

Novità
Errori del compilatore
Avvisi del compilatore
Errori runtime
Migrazione a ActionScript 3
Set di caratteri supportati
Tag solo di MXML
Elementi XML di Motion
Tag Timed Text
Elenco degli elementi obsoleti
Costanti di implementazione dell’accessibilità
Utilizzare gli esempi ActionScript
Note legali
Pacchettoflash.globalization
Classepublic final class CurrencyFormatter
EreditarietàCurrencyFormatter Inheritance Object

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

La classe CurrencyFormatter fornisce la formattazione sensibile al contesto di impostazioni internazionali e l'analisi dei valori valutari.

La classe CurrencyFormatter utilizza i dati e la funzionalità forniti dal sistema operativo ed è progettata per formattare i valori di valuta in base alle convenzioni di un contesto di impostazioni internazionali e di un tipo di valuta specifici. La posizione del simbolo di valuta, del simbolo negativo, del separatore decimale, del separatore di raggruppamento, dello schema di raggruppamento, del separatore dei decimali e di altri elementi può variare in base alle impostazioni internazionali.

Se le impostazioni internazionali richieste sono supportate dal sistema operativo, le proprietà e il tipo di valuta vengono impostati in base alle convenzioni e ai valori predefiniti di tali impostazioni internazionali richieste. Se le impostazioni internazionali richieste non sono disponibili, le proprietà vengono definite in base alle impostazioni internazionali di sistema predefinite o di riserva, che possono essere recuperate tramite la proprietà actualLocaleIDName.

In conseguenza dell'uso delle impostazioni dell'utente, degli schemi di formattazione forniti dal sistema operativo e delle impostazioni internazionali di riserva quando quelle richieste non sono supportate, i risultati della formattazione saranno diversi da utente a utente, anche se questi utilizzano lo stesso ID di impostazioni internazionali.

Vedere gli esempi



Proprietà pubbliche
 ProprietàDefinito da
  actualLocaleIDName : String
[sola lettura] Il nome dell'ID di impostazioni internazionali effettivamente utilizzato da questo oggetto CurrencyFormatter.
CurrencyFormatter
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  currencyISOCode : String
[sola lettura] Il codice di valuta ISO 4217 di tre lettere per le impostazioni internazionali effettivamente utilizzate.
CurrencyFormatter
  currencySymbol : String
[sola lettura] Il simbolo di valuta o la stringa corrispondente alle impostazioni internazionali effettivamente utilizzate.
CurrencyFormatter
  decimalSeparator : String
Il carattere separatore dei decimali utilizzato per formattare o analizzare gli importi in valuta che includono una parte decimale.
CurrencyFormatter
  digitsType : uint
Definisce il set di caratteri cifra utilizzato per la formattazione degli importi in valuta.
CurrencyFormatter
  fractionalDigits : int
Il numero massimo di cifre che possono apparire dopo il separatore dei decimali.
CurrencyFormatter
  groupingPattern : String
Descrive la posizione dei separatori di raggruppamento all'interno della stringa dell''importo in valuta formattata.
CurrencyFormatter
  groupingSeparator : String
Il carattere o la stringa utilizzata come separatore di raggruppamento.
CurrencyFormatter
  lastOperationStatus : String
[sola lettura] Lo stato dell'operazione più recente eseguita da questo oggetto CurrencyFormatter.
CurrencyFormatter
  leadingZero : Boolean
Specifica se viene incluso uno zero iniziale in un importo in valuta formattato quando non sono presenti cifre intere a sinistra del separatore dei decimali.
CurrencyFormatter
  negativeCurrencyFormat : uint
Un valore numerico che indica uno schema di formattazione per gli importi in valuta negativi.
CurrencyFormatter
  negativeSymbol : String
Il simbolo negativo utilizzato per la formattazione degli importi in valuta negativi.
CurrencyFormatter
  positiveCurrencyFormat : uint
Un valore numerico che indica uno schema di formattazione per gli importi in valuta positivi.
CurrencyFormatter
  requestedLocaleIDName : String
[sola lettura] Il nome dell'ID di impostazioni internazionali richiesto che è stato passato alla funzione di costruzione di questo oggetto CurrencyFormatter.
CurrencyFormatter
  trailingZeros : Boolean
Specifica se nell'importo in valuta formattato vengono inclusi zero finali.
CurrencyFormatter
  useGrouping : Boolean
Consente di utilizzare il separatore di raggruppamento per la formattazione degli importi in valuta.
CurrencyFormatter
Metodi pubblici
 MetodoDefinito da
  
CurrencyFormatter(requestedLocaleIDName:String)
Costruisce un nuovo oggetto CurrencyFormatter per formattare i numeri che rappresentano gli importi in valuta in base alle convenzioni di un determinato contesto di impostazioni internazionali.
CurrencyFormatter
  
format(value:Number, withCurrencySymbol:Boolean = false):String
Crea una stringa che rappresenta un importo in valuta formattato in base alle proprietà correnti di questo oggetto CurrencyFormatter, inclusi le impostazioni internazionali, il simbolo di valuta e il codice ISO della valuta.
CurrencyFormatter
  
Determina se il simbolo di valuta attualmente specificato può essere utilizzato per la formattazione degli importi in valuta.
CurrencyFormatter
  
[statico] Elenca tutti i nomi degli ID di impostazioni internazionali supportati da questa classe.
CurrencyFormatter
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
  
Analizza una stringa ottenendo un iporto in valuta con simbolo di valuta.
CurrencyFormatter
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
  
setCurrency(currencyISOCode:String, currencySymbol:String):void
Imposta le proprietà currencyISOCode e currencySymbol dell'oggetto CurrencyFormatter
CurrencyFormatter
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà

actualLocaleIDName

proprietà
actualLocaleIDName:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Il nome dell'ID di impostazioni internazionali effettivamente utilizzato da questo oggetto CurrencyFormatter.

Esistono tre possibilità per il valore del nome, a seconda del sistema operativo e del valore del parametro requestedLocaleIDName passato alla funzione di costruzione CurrencyFormatter().

  1. Se le impostazioni internazionali richieste non corrispondevano al valore LocaleID.DEFAULT e il sistema operativo fornisce il supporto per tali impostazioni internazionali, il nome restituito corrisponde alla proprietà requestedLocaleIDName.
  2. Se è stato utilizzato LocaleID.DEFAULT come valore del parametro requestedLocaleIDName passato alla funzione di costruzione, viene utilizzato il nome delle impostazioni internazionali correnti specificato dal sistema operativo dell'utente. Il valore LocaleID.DEFAULT mantiene l'impostazione personalizzata dell'utente nel sistema operativo. Se passate un valore esplicito come parametro requestedLocaleIDName, non viene necessariamente restituito lo stesso risultato fornito da LocaleID.DEFAULT, anche se i nomi dei due ID di impostazioni internazionali sono gli stessi. L'utente potrebbe avere personalizzato le impostazioni internazionali del computer e la richiesta di un nome esplicito dell'ID di impostazioni internazionali, anziché l'utilizzo di LocaleID.DEFAULT, può impedire all'applicazione di rilevare tali impostazioni personalizzate.
  3. Se il sistema operativo non supporta il parametro requestedLocaleIDName specificato nella funzione di costruzione, viene fornito un nome dell'ID di impostazioni internazionali di riserva.



Implementazione
    public function get actualLocaleIDName():String

Elementi API correlati

currencyISOCode

proprietà 
currencyISOCode:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Il codice di valuta ISO 4217 di tre lettere per le impostazioni internazionali effettivamente utilizzate.

Questo codice viene utilizzato per determinare la stringa o il simbolo di valuta durante la formattazione degli importi in valuta tramite il metodo format() con il parametro withCurrencySymbol impostato su false.

Questa proprietà viene inizializzata dalla funzione di costruzione in base alle impostazioni internazionali effettivamente utilizzate. Quando vengono utilizzate le impostazioni internazionali di riserva, questa proprietà riflette il codice di valuta preferito e predefinito di tali impostazioni internazionali di riserva.

Il valore predefinito è dependent on the actual locale and operating system.



Implementazione
    public function get currencyISOCode():String

Elementi API correlati

currencySymbol

proprietà 
currencySymbol:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Il simbolo di valuta o la stringa corrispondente alle impostazioni internazionali effettivamente utilizzate.

Questa proprietà viene utilizzata come simbolo di valuta durante la formattazione degli importi in valuta tramite il metodo format() con il parametro withCurrencySymbol impostato su true.

Questa proprietà viene inizializzata dalla funzione di costruzione in base alle impostazioni internazionali effettivamente utilizzate. Quando vengono utilizzate le impostazioni internazionali di riserva, questa proprietà riflette il simbolo di valuta preferito e predefinito di tali impostazioni internazionali di riserva.

Il valore predefinito è dependent on the actual locale and operating system.



Implementazione
    public function get currencySymbol():String

Elementi API correlati

decimalSeparator

proprietà 
decimalSeparator:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Il carattere separatore dei decimali utilizzato per formattare o analizzare gli importi in valuta che includono una parte decimale.

Questa proprietà viene impostata inizialmente in base alle impostazioni internazionali selezionate durante la costruzione dell'oggetto formatter.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the actual locale and operating system.



Implementazione
    public function get decimalSeparator():String
    public function set decimalSeparator(value:String):void

Genera
TypeError — Se a questa proprietà è assegnato un valore null.

Elementi API correlati

digitsType

proprietà 
digitsType:uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Definisce il set di caratteri cifra utilizzato per la formattazione degli importi in valuta.

Lingue e aree diverse utilizzano set di caratteri diversi per rappresentare le cifre da 0 a 9. Questa proprietà definisce il set di cifre da utilizzare.

Il valore di questa proprietà rappresenta il valore Unicode per la cifra zero di un set di cifre decimali. I valori validi per questa proprietà sono definiti nella classe NationalDigitsType.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the actual locale and operating system.



Implementazione
    public function get digitsType():uint
    public function set digitsType(value:uint):void

Genera
TypeError — Se a questa proprietà è assegnato un valore null.

Elementi API correlati

fractionalDigits

proprietà 
fractionalDigits:int

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Il numero massimo di cifre che possono apparire dopo il separatore dei decimali.

I numeri vengono arrotondati al numero di cifre specificato da questa proprietà. Lo schema di arrotondamento varia a seconda del sistema operativo dell'utente.

Quando la proprietà trailingZeros è impostata su true, le parti frazionarie del numero (dopo la virgola decimale) vengono completate con zero finali finché la lunghezza non corrisponde al valore della proprietà fractionalDigits.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è 0.



Implementazione
    public function get fractionalDigits():int
    public function set fractionalDigits(value:int):void

Elementi API correlati

groupingPattern

proprietà 
groupingPattern:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Descrive la posizione dei separatori di raggruppamento all'interno della stringa dell''importo in valuta formattata.

Quando la proprietà useGrouping è impostata su true, la proprietà groupingPattern viene utilizzata per definire la posizione e lo schema utilizzati per il separatore di raggruppamento.

Lo schema di raggruppamento viene definito sotto forma di stringa contenente numeri separati da punti e virgola e facoltativamente terminata con un asterisco. Ad esempio: "3;2;*". Ogni numero nella stringa rappresenta il numero di cifre in un gruppo. Il separatore di raggruppamento viene inserito prima di ogni gruppo di cifre. Un asterisco alla fine della stringa indica che i gruppi contenenti tale numero di cifre dovranno essere ripetuti nel resto della stringa formattata. Se non è presente un asterisco, nel resto della stringa formattata non vi sono gruppi o separatori aggiuntivi.

Il primo numero contenuto nella stringa corrisponde al primo gruppo di cifre a sinistra del separatore dei decimali. I numeri successivi definiscono il numero di cifre nei successivi gruppi a sinistra. La stringa "3;2;*" indica pertanto che viene inserito un separatore di raggruppamento dopo il primo gruppo di 3 cifre, seguito da gruppi di 2 cifre. Ad esempio: 98,76,54,321

Nella seguente tabella sono illustrati esempi di formattazione dell'importo in valuta 123456789.12 con vari schemi di raggruppamento. Il separatore di raggruppamento è una virgola, il separatore dei decimali è un punto e il simbolo del dollaro ($) è il simbolo di valuta.

Schema di raggruppamentoFormato di esempio
3;* $123,456,789.12
3;2;*$12,34,56,789.12
3$123456,789.12

Potete definire solo un numero limitato di dimensioni di raggruppamento. In alcuni sistemi operativi, gli schemi di raggruppamento possono contenere solo due numeri e un asterisco. Altri sistemi operativi possono supportare fino a quattro numeri e un asterisco. Per gli schemi senza asterisco, alcuni sistemi operativi supportano un solo numero, mentre altri supportano fino a tre numeri. Se il numero massimo di elementi dello schema di raggruppamento viene superato, gli elementi aggiuntivi vengono ignorati e la proprietà lastOperationStatus viene impostata come descritto di seguito.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.



Implementazione
    public function get groupingPattern():String
    public function set groupingPattern(value:String):void

Genera
TypeError — Se a questa proprietà è assegnato un valore null.

Elementi API correlati

groupingSeparator

proprietà 
groupingSeparator:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Il carattere o la stringa utilizzata come separatore di raggruppamento.

Il valore di questa proprietà viene utilizzato come separatore di raggruppamento durante la formattazione degli importi in valuta se la proprietà useGrouping è impostata su true. Questa proprietà viene impostata inizialmente in base alle impostazioni internazionali selezionate durante la costruzione dell'oggetto formatter.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the actual locale and operating system.



Implementazione
    public function get groupingSeparator():String
    public function set groupingSeparator(value:String):void

Genera
TypeError — Se a questa proprietà è assegnato un valore null.

Elementi API correlati

lastOperationStatus

proprietà 
lastOperationStatus:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Lo stato dell'operazione più recente eseguita da questo oggetto CurrencyFormatter. La proprietà lastOperationStatus viene impostata ogni volta che chiamate una funzione di costruzione o un metodo di questa classe oppure impostate un'altra proprietà. Per i valori possibili, fate riferimento alla descrizione dei singoli metodi.



Implementazione
    public function get lastOperationStatus():String

Elementi API correlati

leadingZero

proprietà 
leadingZero:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Specifica se viene incluso uno zero iniziale in un importo in valuta formattato quando non sono presenti cifre intere a sinistra del separatore dei decimali.

Quando questa proprietà è impostata su true a sinistra del separatore dei decimali viene incluso uno zero iniziale durante la formattazione di valori numeri compresi tra -1.0 e 1.0. Quando questa proprietà è impostata su false, non viene incluso uno zero iniziale.

Se l'importo in valuta è, ad esempio, 0.321 e la proprietà è impostata su true, nella stringa formattata viene incluso lo zero iniziale. Se la proprietà è impostata su false, lo zero iniziale non viene incluso. In tal caso la stringa contiene solo il separatore dei decimali seguito dalle cifre decimali, ad esempio $.321.

Nella seguente tabella sono riportati esempi di formattazione degli importi in valuta in base ai valori di questa proprietà e alle proprietà correlate fractionalDigits e trailingZeros.

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

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the actual locale and operating system.



Implementazione
    public function get leadingZero():Boolean
    public function set leadingZero(value:Boolean):void

Genera
TypeError — Se a questa proprietà è assegnato un valore null.

Elementi API correlati

negativeCurrencyFormat

proprietà 
negativeCurrencyFormat:uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Un valore numerico che indica uno schema di formattazione per gli importi in valuta negativi. Questo schema definisce la posizione del simbolo di valuta e del simbolo negativo o delle parentesi rispetto alla parte numerica dell'importo in valuta.

Il valore di questa proprietà deve essere una delle costanti definite nella tabella sottostante.

Nella tabella seguente sono riepilogati i possibili schemi di formattazione per gli importi in valuta negativi. Quando un importo in valuta viene formattato con il metodo format():

  • il simbolo "¤" viene sostituito con il valore della proprietà currencyISOCode o currencySymbol, a seconda del valore del parametro withCurrencySymbol passato al metodo format();
  • il carattere "-" viene sostituito con il valore della proprietà negativeNumberSymbol;
  • Il carattere "n" viene sostituito con il valore dell'importo in valuta passato al metodo format().
Tipo di formato di valuta negativoSchema di formattazione
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 ¤)

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the actual locale and operating system.



Implementazione
    public function get negativeCurrencyFormat():uint
    public function set negativeCurrencyFormat(value:uint):void

Genera
ArgumentError — Se il valore assegnato non è compreso tra 0 e 15.

Elementi API correlati

negativeSymbol

proprietà 
negativeSymbol:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Il simbolo negativo utilizzato per la formattazione degli importi in valuta negativi.

Questo simbolo viene utilizzato insieme al formato di valuta negativo durante la formattazione di un importo in valuta minore di zero. Non viene usato nei formati di valuta negativi che non includono un segno negativo (ad esempio, quando gli importi in valuta negativi sono racchiusi tra parentesi).

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the actual locale and operating system.



Implementazione
    public function get negativeSymbol():String
    public function set negativeSymbol(value:String):void

Genera
TypeError — Se a questa proprietà è assegnato un valore null.

Elementi API correlati

positiveCurrencyFormat

proprietà 
positiveCurrencyFormat:uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Un valore numerico che indica uno schema di formattazione per gli importi in valuta positivi. Questo formato definisce la posizione del simbolo di valuta rispetto alla parte numerica dell'importo in valuta.

Il valore di questa proprietà deve essere una delle costanti definite nella tabella sottostante.

Nella tabella seguente sono riepilogati i possibili schemi di formattazione per gli importi in valuta positivi. Quando un importo in valuta viene formattato con il metodo format():

  • il simbolo "¤" viene sostituito con il valore della proprietà currencyISOCode o currencySymbol, a seconda del valore del parametro withCurrencySymbol passato al metodo format();
  • Il carattere "n" viene sostituito con il valore dell'importo in valuta passato al metodo format().
Tipo di formato di valuta positivoSchema di formattazione
0¤n
1
2¤ n
3n ¤

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the actual locale and operating system.



Implementazione
    public function get positiveCurrencyFormat():uint
    public function set positiveCurrencyFormat(value:uint):void

Genera
ArgumentError — Se il valore assegnato non è compreso tra 0 e 3.

Elementi API correlati

requestedLocaleIDName

proprietà 
requestedLocaleIDName:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Il nome dell'ID di impostazioni internazionali richiesto che è stato passato alla funzione di costruzione di questo oggetto CurrencyFormatter.

Se è stato utilizzato il valore LocaleID.DEFAULT, il nome restituito è "i-default". Quando vengono applicate impostazioni internazionali di riserva, le impostazioni internazionali effettivamente utilizzate possono essere diverse da quelle richieste. Il nome delle impostazioni internazionali effettive può essere recuperato utilizzando la proprietà actualLocaleIDName.



Implementazione
    public function get requestedLocaleIDName():String

Elementi API correlati

trailingZeros

proprietà 
trailingZeros:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Specifica se nell'importo in valuta formattato vengono inclusi zero finali.

Quando questa proprietà è impostata su true, nella parte frazionaria del numero formattato vengono inclusi zero finali fino al limite specificato dalla proprietà fractionalDigits. Quando questa proprietà è impostata su false, non vengono visualizzati zero finali.

Se, ad esempio, l'importo in valuta è 123.4, questa proprietà è impostata su true e la proprietà fractionalDigits è impostata su 3, la stringa formattata includerà zero finali, ad esempio $123.400. Se questa proprietà è false, non vengono inclusi zero finali e nella stringa viene visualizzato solo il separatore dei decimali seguito dalle cifre decimali diverse da zero, ad esempio $123.4.

Nella seguente tabella sono riportati esempi di formattazione degli importi in valuta in base ai valori di questa proprietà e alle proprietà correlate fractionalDigits e leadingZero.

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

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the actual locale and operating system.



Implementazione
    public function get trailingZeros():Boolean
    public function set trailingZeros(value:Boolean):void

Genera
TypeError — Se a questa proprietà è assegnato un valore null.

Elementi API correlati

useGrouping

proprietà 
useGrouping:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Consente di utilizzare il separatore di raggruppamento per la formattazione degli importi in valuta.

Quando la proprietà useGrouping è impostata su true, le cifre vengono raggruppate e delimitate dal carattere utilizzato come separatore di raggruppamento. Ad esempio: $123,456,789

Quando la proprietà useGrouping è impostata su false, le cifre non vengono raggruppato né separate. Ad esempio: $123456789

La proprietà groupingSeparator definisce il simbolo da utilizzare come separatore di raggruppamento. La proprietà groupingPattern definisce il numero di cifre tra i separatori di raggruppamento.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.



Implementazione
    public function get useGrouping():Boolean
    public function set useGrouping(value:Boolean):void

Elementi API correlati

Descrizione della funzione di costruzione

CurrencyFormatter

()Funzione di costruzione
public function CurrencyFormatter(requestedLocaleIDName:String)

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Costruisce un nuovo oggetto CurrencyFormatter per formattare i numeri che rappresentano gli importi in valuta in base alle convenzioni di un determinato contesto di impostazioni internazionali.

Questa funzione di costruzione determina se il sistema operativo corrente supporta il nome dell'ID di impostazioni internazionali richiesto. Se non è supportato, vengono utilizzate delle impostazioni internazionali di riserva. Se vengono utilizzate impostazioni internazionali di riserva, la proprietà lastOperationStatus indica il tipo di riserva e la proprietà actualLocaleIDName contiene il nome dell'ID di impostazioni locali di riserva.

Alcune proprietà, come currencySymbol e currencyISOCode, vengono impostate automaticamente in base alle impostazioni internazionali.

NOTA: quando si utilizzano le impostazioni internazionali di riserva, le proprietà della valuta vengono impostate sui valori predefiniti, di conseguenza è possibile che alla proprietà currencySymbol o currencyISOCode vengano assegnati valori imprevisti. È pertanto opportuno esaminare i valori delle proprietà currencySymbol e currencyISOCode prima di formattare un importo in valuta.

Per applicare la formattazione in base alle preferenze del sistema operativo corrente dell'utente, passate alla funzione di costruzione il valore LocaleID.DEFAULT nel parametro requestedLocaleIDName.

Quando la funzione di costruzione viene chiamata e completata correttamente, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Quando il nome dell'ID di impostazioni internazionali richiesto non è disponibile, lastOperationStatus è impostata su uno dei valori seguenti:

  • LastOperationStatus.USING_FALLBACK_WARNING
  • LastOperationStatus.USING_DEFAULT_WARNING

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Per informazioni dettagliate sugli avvisi sopra indicati e altri possibili valori della proprietà lastOperationStatus, fate riferimento alle descrizioni disponibili nella classe LastOperationStatus.

Parametri
requestedLocaleIDName:String — Il nome dell'ID di impostazioni internazionali preferite da utilizzare per determinare i formati di data e ora.

Genera
TypeError — Se il parametro requestedLocaleIDName è null.

Elementi API correlati

Descrizione dei metodi

format

()metodo
public function format(value:Number, withCurrencySymbol:Boolean = false):String

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Crea una stringa che rappresenta un importo in valuta formattato in base alle proprietà correnti di questo oggetto CurrencyFormatter, inclusi le impostazioni internazionali, il simbolo di valuta e il codice ISO della valuta.

Per impostazione predefinita, questo metodo utilizza la proprietà currencyISOCode per determinare il simbolo di valuta e altre impostazioni utilizzate durante la formattazione.

In molti paesi e aree vengono utilizzati gli stessi simboli di valuta per diverse valute. Ad esempio, Stati Uniti, Australia, Nuova Zelanda, Canada e Messico utilizzano tutti lo stesso simbolo di dollaro ($) per i valori di valuta locali. Quando la valuta per la formattazione differisce da quella locale dell'utente, è preferibile utilizzare il codice ISO come stringa di valuta. Potete usare il metodo formattingWithCurrencySymbolIsSafe() per verificare se il codice ISO della valuta da formattare corrisponde alla proprietà currencyISOCode del formatter.

Questo metodo consente di formattare i numeri molto grandi o molto piccoli. Il numero di cifre significative è tuttavia limitato dalla precisione fornita dal tipo di dati Number.

Parametri

value:Number — Il valore numerico da formattare in una stringa in valuta.
 
withCurrencySymbol:Boolean (default = false) — Quando è impostata su false, la proprietà currencyISOCode determina la stringa o il simbolo di valuta da utilizzare nella stringa di output. Quando è impostata su true, nella stringa di output viene utilizzato il valore corrente della proprietà currencySymbol.

Restituisce
String — Una stringa contenente il valore in valuta formattato.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
In questo esempio sono richieste le impostazioni internazionali fr-CA francese (Canada). Nell'esempio si presuppone che queste impostazioni internazionali siano supportate dal sistema operativo dell'utente, pertanto non vengono utilizzate impostazioni internazionali di riserva. Per fr-CA la valuta predefinita è il dollaro canadese con il codice ISO CAD. In questo caso, per la formattazione di una valuta con i valori predefiniti viene utilizzato CAD come simbolo di valuta. Quando il parametro withCurrencySymbol è impostato su true, per formattare l'importo in valuta viene utilizzata la proprietà 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 $"
         

Nel secondo esempio è illustrato un metodo di formattazione di un imposto in valuta in dollari canadesi utilizzando le impostazioni internazionali predefinite dell'utente. Il metodo formattingWithCurrencySymbolIsSafe() viene utilizzato per verificare se la valuta predefinita dell'utente è il dollaro canadesi e, in caso affermativo, viene utilizzato il metodo format con il parametro withCurrencySymbol impostato su true. In caso contrario, la valuta è impostata sul dollaro canadese con un simbolo di valuta più descrittivo. Nell'esempio viene illustrato come sarebbe formattata la valuta se le impostazioni internazionali predefinite fossero francese (Canada) o inglese (Stati Uniti).

 
         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

()metodo 
public function formattingWithCurrencySymbolIsSafe(requestedISOCode:String):Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Determina se il simbolo di valuta attualmente specificato può essere utilizzato per la formattazione degli importi in valuta.

Molti paesi e regioni utilizzano gli stessi simboli di valuta. Potete utilizzare questo metodo per evitare che venga utilizzato un simbolo di valuta ambiguo oppure un simbolo di valuta o un codice ISO diverso da quello previsto a causa dell'uso di impostazioni internazionali di riserva.

È prassi comune utilizzare questo metodo per determinare se visualizzare un simbolo di valuta locale (se l'importo viene formattato nella valuta predefinita dell'utente) o una stringa di codice ISO più specifica (se l'importo viene formattato in una valuta diversa da quella predefinita dell'utente).

Questo metodo confronta il parametro requestedISOCode con la proprietà currencyISOCode corrente, restituendo true se le stringhe corrispondono e false in caso contrario. Quando le stringhe corrispondono, l'utilizzo del metodo format() con il parametro withCurrencySymbol impostato su true restituisce una stringa di valori di valuta formattata con un simbolo di valuta univoco per il contesto di impostazioni internazionali. Se il metodo restituisce false, l'utilizzo del metodo format() con il parametro withCurrencySymbol impostato su true può comportare l'utilizzo di un simbolo di valuta ambiguo o non corretto.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

requestedISOCode:String — Un codice di valuta ISO 4217 di tre lettere (ad esempio USD per dollari USA, EUR per euro). Deve contenere tre lettere maiuscole dalla A alla Z.

Restituisce
Booleantrue se la proprietà currencyISOCode corrisponde al parametro requestedISOCode; altrimenti false.

Genera
TypeError — Se il parametro requestedISOCode è null.

Elementi API correlati

getAvailableLocaleIDNames

()metodo 
public static function getAvailableLocaleIDNames():Vector.<String>

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Elenca tutti i nomi degli ID di impostazioni internazionali supportati da questa classe.

Se questa classe non è supportata dal sistema operativo corrente, il metodo restituisce un valore null.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Restituisce
Vector.<String> — Un vettore di stringhe contenente tutti i nomi degli ID di impostazioni internazionali supportati da questa classe.

parse

()metodo 
public function parse(inputString:String):CurrencyParseResult

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Analizza una stringa ottenendo un importo in valuta con simbolo di valuta.

L'algoritmo di analisi utilizza il valore della proprietà decimalSeparator per determinare la parte intera e frazionaria del numero. Utilizza i valori delle proprietà negativeCurrencyFormat e positiveCurrencyFormat per determinare la posizione della stringa o del simbolo di valuta rispetto all'importo in valuta. Per gli importi negativi, il valore della proprietà negativeCurrencyFormat determina la posizione del simbolo negativo e l'eventuale utilizzo di parentesi.

Se l'ordine del simbolo di valuta, il segno meno, e il numero nella stringa di input non corrispondono allo schema identificato dalle proprietà negativeCurrencyFormat e positiveCurrencyFormat, vengono effettuate le seguenti operazioni:

  1. La proprietà value dell'oggetto CurrencyParseResult restituito viene impostata su NaN.
  2. La proprietà currencyString dell'oggetto CurrencyParseResult restituito viene impostata su null.
  3. La proprietà lastOperationStatus viene impostata in modo da indicare l'esito negativo dell'analisi.

La stringa di input potrebbe includere caratteri spazio, che durante l'analisi vengono ignorati.

L'analisi può avere esito positivo anche se non è presente un simbolo di valuta. Non viene effettuata alcuna convalida Per la parte della stringa che corrisponde al simbolo di valuta non viene effettuata alcuna convalida. Se non è presente una stringa o un simbolo di valuta, la proprietà currencyString nell'oggetto CurrencyParseResult restituito viene impostata su una stringa vuota.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

inputString:String — La stringa di input da analizzare.

Restituisce
CurrencyParseResult — Un oggetto CurrencyParseResult contenente il valore numerico e la stringa o il simbolo di valuta.

Genera
TypeError — Se il parametro inputString è null.

Elementi API correlati

setCurrency

()metodo 
public function setCurrency(currencyISOCode:String, currencySymbol:String):void

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.1, AIR 2

Imposta le proprietà currencyISOCode e currencySymbol dell'oggetto CurrencyFormatter.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

  • LastOperationStatus.NO_ERROR

In caso contrario, le proprietà currencyISOCode e currencySymbol non vengono modificate e la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

currencyISOCode:String — Il codice di valuta ISO 4217 di tre lettere (ad esempio USD per dollari USA, EUR per euro). Deve contenere tre lettere maiuscole dalla A alla Z.
 
currencySymbol:String — La stringa o il simbolo di valuta da utilizzare per la formattazione dei valori di valuta. Può essere una stringa vuota.


Genera
TypeError — Se il parametro currencyISOCode o currencySymbol è null.

Elementi API correlati

CurrencyFormatterExample.as

Di seguito è illustrata la diversa formattazione di un importo in valuta, a seconda delle diverse valute e impostazioni locali. I risultati di questo esempio saranno diversi, a seconda del sistema operativo in uso e delle preferenze dell'utente.

In questo esempio vengono utilizzate le seguenti impostazioni internazionali:

  • Le impostazioni internazionali predefinite del sistema operativo per la formattazione della valuta (LocaleID.DEFAULT)
  • Giapponese (Giappone)
  • Inglese (Stati Uniti)
  • Francese (Francia)

Nell'esempio vengono effettuate le seguenti operazioni per ogni contesto di impostazioni internazionali incluso nell'elenco:

  1. Crea un oggetto CurrencyFormatter.
  2. Utilizza il metodo formattingWithCurrencySymbolIsSafe() per verificare se la valuta predefinita per le impostazioni internazionali corrisponde a euro ("EUR") e, in tal caso, formatta la stringa utilizzando il simbolo di valuta. Diversamente, formatta la stringa utilizzando il codice 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

Nel seguente esempio viene analizzato l'importo in valuta utilizzando le regole di un determinato contesto di impostazioni internazionali. I risultati di questo esempio possono essere diversi, a seconda del sistema operativo in uso e delle preferenze dell'utente.

In questo esempio viene eseguita la procedura seguente:

  1. Crea un oggetto CurrencyFormatter per le impostazioni internazionali Inglese (Stati Uniti).
  2. Utilizza il metodo parse() per analizzare la stringa di input.
  3. Visualizza l'importo e i valori della stringa in valuta dall'oggetto CurrencyParseResult risultante.
 
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 ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.