flash.globalizationDateTimeFormatter La classe DateTimeFormatter permet le formatage des objets Date en fonction des paramètres régionaux, ainsi qu’un accès aux noms de champs de données localisés.Object La classe DateTimeFormatter permet le formatage des objets Date en fonction des paramètres régionaux, ainsi qu’un accès aux noms de champs de données localisés. Les méthodes de cette classe utilisent les fonctions et les paramètres fournis par le système d’exploitation.

Il existe deux manières de sélectionner un format de date et d’heure : au moyen d’un modèle prédéfini ou d’un modèle personnalisé. Pour la plupart des applications, les styles prédéfinis spécifiés par la constante DateTimeStyle (LONG, MEDIUM, NONEou SHORT doivent être utilisés. Ces constantes spécifient les modèles par défaut en fonction des paramètres régionaux requis ou les modèles par défaut basés sur les paramètres du système d’exploitation de l’utilisateur.

Par exemple, le code suivant crée une chaîne de date à l’aide du format de date court par défaut :

var df:DateTimeFormatter = new DateTimeFormatter(LocaleID.DEFAULT, DateTimeStyle.SHORT, DateTimeStyle.NONE); var currentDate:Date = new Date(); var shortDate:String = df.format(currentDate);

Lorsqu’une occurrence de cette classe est créée, si les paramètres régionaux sont pris en charge par le système d’exploitation, les propriétés de l’occurrence sont définies en fonction des conventions et des valeurs par défaut des paramètres régionaux requis, ainsi que des paramètres dateStyle et timeStyle du constructeur. Si les paramètres régionaux requis ne sont pas disponibles, les propriétés sont définies en fonction de paramètres régionaux par défaut, pouvant être obtenus à l’aide de la propriété actualLocaleIDName.

Cette classe contient d’autres méthodes pour obtenir les chaînes localisées correspondant au nom des mois et des jours de la semaine, ainsi que le premier jour de la semaine pouvant être utilisé dans un sélecteur de calendrier ou d’autres applications similaires.

En raison de l’utilisation des paramètres définis par l’utilisateur, des modèles de formatage fournis par le système d’exploitation et des paramètres régionaux par défaut (lorsque les paramètres régionaux requis ne sont pas pris en charge), différents utilisateurs peuvent obtenir différents résultats de formatage, même s’ils ont recours au même ID de paramètres régionaux.

L’exemple suivant explique comment formater les chaînes représentant des valeurs de date et d’heure différemment en fonction des paramètres régionaux. Notez que les résultats de cet exemple peuvent varier en fonction du système d’exploitation et des préférences de l’utilisateur.

Cet exemple utilise les paramètres régionaux suivants : Anglais (Etats-Unis), Français (France), Espagnol (Espagne).

Cet exemple effectue les opérations suivantes pour chaque jeu de paramètres régionaux dans la liste :

Crée un objet DateTimeFormatter à l’aide d’un style par défaut (style de date long, style d’heure long).
Formate la date et l’heure actuelles à l’aide du style de date long par défaut.
Passe à un style de date court d’affichage de l’heure uniquement à l’aide des constantes DateTimeStyle.NONE et DateTimeStyle.SHORT.
Formate la date et l’heure actuelles à l’aide du style de date court d’affichage de l’heure uniquement.

package { import flash.display.Sprite; import flash.globalization.DateTimeFormatter; import flash.globalization.DateTimeStyle; public class DateTimeFormatterExample extends Sprite { private var localeList:Array = new Array("en-US", "fr-FR", "es-ES"); public function DateTimeFormatterExample() { var date:Date = new Date(); for each (var locale:String in localeList) { var dtf:DateTimeFormatter = new DateTimeFormatter(locale); trace('\n' + "LocaleID requested=" + dtf.requestedLocaleIDName + "; actual=" + dtf.actualLocaleIDName); var longDate:String = dtf.format(date); trace(longDate + " (" + dtf.getDateTimePattern() + ")"); dtf.setDateTimeStyles(DateTimeStyle.NONE, DateTimeStyle.SHORT); var shortDate:String = dtf.format(date); trace(shortDate + " (" + dtf.getDateTimePattern() + ")"); } } } } L’exemple suivant indique comment une application peut formater une date en fonction d’un modèle sélectionné par l’utilisateur. Notez que les résultats de cet exemple peuvent varier en fonction du système d’exploitation et des préférences de l’utilisateur.

Cet exemple effectue les opérations suivantes pour chaque jeu de paramètres régionaux dans la liste :

Crée trois champs de texte d’entrée et de sortie.
Crée un objet DateTimeFormatter à l’aide du jeu de paramètres régionaux Anglais (Etats-Unis).
Appelle la fonction configureTextField(), qui définit la position et la taille des champs de texte, et ajoute un écouteur d’événement à l’objet patternField.
Lorsque l’utilisateur saisit un modèle dans le champ de texte patternField, la fonction textInputHandler formate la date et l’heure actuelles à l’aide de ce modèle, puis affiche le résultat et la valeur lastOperationStatus dans les champs de texte de sortie.

package { import flash.display.Sprite; import flash.events.Event; import flash.globalization.DateTimeFormatter; import flash.text.*; public class DateTimePatternExample extends Sprite { private var patternField:TextField = new TextField(); private var resultField:TextField = new TextField(); private var statusField:TextField = new TextField(); private var date:Date = new Date(); private var dtf:DateTimeFormatter = new DateTimeFormatter("en-US"); private function configureTextField():void { patternField.type = TextFieldType.INPUT; patternField.width = 300; patternField.height = 20; patternField.background = true; patternField.border = true; resultField.y = 40; resultField.width = 300; resultField.height = 20; statusField.y = 80; statusField.width = 300; statusField.height = 20; addChild(patternField); addChild(resultField); addChild(statusField); patternField.addEventListener(Event.CHANGE,textInputHandler); } private function textInputHandler(event:Event):void { dtf.setDateTimePattern(patternField.text); statusField.text = dtf.lastOperationStatus; resultField.text = dtf.format(date); } public function DateTimePatternExample() { configureTextField(); } } } DateTimeFormatter Construit un nouvel objet DateTimeFormatter en vue de formater les dates et les heures conformément aux conventions des paramètres régionaux spécifiés, ainsi qu’aux styles de formatage de la date et de l’heure fournis.si le paramètre dateStyle ou timeStyle n’est pas une constante DateTimeStyle valide. ArgumentErrorArgumentErrorsi le paramètre dateStyle ou timeStyle est défini sur null. TypeErrorTypeErrorrequestedLocaleIDNameStringNom de l’identificateur de paramètres régionaux à utiliser lors de la spécification des formats de date ou d’heure. dateStyleStringlongSpécifie le style à utiliser lors du formatage des dates. La valeur correspond à l’une des valeurs énumérées par la classe DateTimeStyle :

DateTimeStyle.LONG
DateTimeStyle.MEDIUM
DateTimeStyle.SHORT
DateTimeStyle.NONE

timeStyleStringlongSpécifie le style à utiliser lors du formatage des heures. La valeur correspond à l’une des valeurs énumérées par la classe DateTimeStyle :

DateTimeStyle.LONG
DateTimeStyle.MEDIUM
DateTimeStyle.SHORT
DateTimeStyle.NONE

Construit un nouvel objet DateTimeFormatter en vue de formater les dates et les heures conformément aux conventions des paramètres régionaux spécifiés, ainsi qu’aux styles de formatage de la date et de l’heure fournis. Les styles de date et d’heure sont utilisés pour définir les modèles de formatage de date et d’heure sur les modèles prédéfinis en fonction des paramètres régionaux à partir du système d’exploitation.

Ce constructeur détermine si le système d’exploitation actuel prend en charge le nom de l’identificateur de paramètres régionaux requis. Si ce n’est pas le cas, des paramètres régionaux de substitution sont utilisés. Il est possible de déterminer le nom de l’ID des paramètres régionaux de substitution via la propriété actualLocaleIDName.

Si une valeur de substitution est utilisée pour l’un des paramètres requestedLocaleIDName, dateStyle ou timeStyle, la propriété lastOperationStatus est définie pour indiquer le type de valeur de substitution.

Pour effectuer un formatage en fonction des préférences de l’utilisateur du système d’exploitation actuel, transmettez la valeur LocaleID.DEFAULT du paramètre requestedLocaleIDName au constructeur.

Lorsque le constructeur est appelé et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Lorsque le nom de l’identificateur de paramètres régionaux requis n’est pas disponible, la propriété lastOperationStatus est définie sur l’une des valeurs suivantes :

LastOperationStatus.USING_FALLBACK_WARNING
LastOperationStatus.USING_DEFAULT_WARNING

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Pour plus d’informations sur les avertissements répertoriés ci-dessus et d’autres valeurs possibles de la propriété lastOperationStatus, voir les descriptions de la classe LastOperationStatus.

formatUTC Formate une chaîne d’affichage pour un objet Date interprété comme étant en heure UTC (utilisation des composants UTC de l’objet Date, tels que dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC et secondsUTC), conformément au modèle dateStyle, timeStyle ou dateTime.Chaîne formatée représentant la valeur de date ou d’heure. StringdateTimeDateValeur Date devant être formatée. Formate une chaîne d’affichage pour un objet Date interprété comme étant en heure UTC (utilisation des composants UTC de l’objet Date, tels que dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC et secondsUTC), conformément au modèle dateStyle, timeStyle ou dateTime. Le formatage est effectué à l’aide des conventions de l’ID de paramètres régionaux et des styles de date et d’heure, ou à l’aide d’un modèle de date ou d’heure personnalisé, spécifiés pour cette occurrence de DateTimeFormatter.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

format Formate une chaîne d’affichage pour un objet Date interprété comme étant en heure locale de l’utilisateur (utilisation des composants d’heure locale de l’objet Date, tels que date, day, fullYear, hours, minutes, month et seconds).Chaîne formatée représentant la valeur de date ou d’heure. StringdateTimeDateValeur Date devant être formatée. Formate une chaîne d’affichage pour un objet Date interprété comme étant en heure locale de l’utilisateur (utilisation des composants d’heure locale de l’objet Date, tels que date, day, fullYear, hours, minutes, month et seconds). Le formatage est effectué à l’aide des conventions de l’ID de paramètres régionaux et des styles de date et d’heure, ou à l’aide d’un modèle de date ou d’heure personnalisé, spécifiés pour cette occurrence de DateTimeFormatter.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

getAvailableLocaleIDNames Répertorie tous les noms des ID de paramètres régionaux pris en charge par cette classe.Vecteur de chaînes contenant tous les noms des identificateurs de paramètres régionaux pris en charge par cette classe. Répertorie tous les noms des ID de paramètres régionaux pris en charge par cette classe.

Si cette classe n’est pas prise en charge sur le système d’exploitation actuel, cette méthode renvoie une valeur nulle.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

getDateStyle Obtient le style de date de cette occurrence de DateTimeFormatter.Chaîne de style de date de cet outil de formatage.

Valeurs possibles :

DateTimeStyle.LONG
DateTimeStyle.MEDIUM
DateTimeStyle.SHORT
DateTimeStyle.NONE
DateTimeStyle.CUSTOM

String Obtient le style de date de cette occurrence de DateTimeFormatter. Le style de date permet d’extraire un modèle de formatage de date prédéfini du système d’exploitation. La valeur de style de date peut être définie par le constructeurDateTimeFormatter(), la méthode setDateTimeStyles() ou la méthode setDateTimePattern().

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

getDateTimePattern Renvoie la chaîne modèle utilisée par cet objet DateTimeFormatter pour formater la date et l’heure.Chaîne contenant le modèle utilisé par cet objet DateTimeFormatter pour formater les dates et les heures. String Renvoie la chaîne modèle utilisée par cet objet DateTimeFormatter pour formater la date et l’heure.

Ce modèle peut être défini de l’une des trois façons suivantes :

Via les paramètres dateStyle et timeStyle utilisés dans le constructeur
Via la méthode setDateTimeStyles()
Via la méthode setDateTimePattern().

Pour obtenir une description de la syntaxe du modèle, voir la méthode setDateTimePattern().

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

getFirstWeekday Renvoie un nombre entier correspondant au premier jour de la semaine les paramètres régionaux et le système calendaire spécifiés.Entier correspondant au premier jour de la semaine pour les paramètres régionaux et le système calendaire spécifiés. int Renvoie un nombre entier correspondant au premier jour de la semaine pour les paramètres régionaux et le système calendaire spécifiés. La valeur 0 correspond à dimanche, 1 correspond à lundi et ainsi de suite, jusqu’à la valeur 6 qui correspond au samedi.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

getMonthNames Extrait une liste de chaînes localisées contenant le nom des mois du système calendaire actuel.si le paramètre nameStyle ou context est défini sur null. TypeErrorTypeErrorVecteur de chaînes localisées contenant le nom des mois pour les paramètres régionaux, le nom du style et le contexte spécifiés. Le premier élément du vecteur, à l’index 0, correspond au nom du premier mois de l’année ; l’élément suivant correspond au nom du deuxième mois de l’année, et ainsi de suite. nameStyleStringfullIndique la chaîne de style de nom à utiliser. Les valeurs possibles sont :

DateTimeNameStyle.FULL
DateTimeNameStyle.LONG_ABBREVIATION
DateTimeNameStyle.SHORT_ABBREVIATION

contextStringstandaloneCode indiquant le contexte d’utilisation de la la chaîne formatée. Ce contexte diffère uniquement pour certains paramètres régionaux. Les valeurs possibles sont :

DateTimeNameContext.FORMAT
DateTimeNameContext.STANDALONE

Extrait une liste de chaînes localisées contenant le nom des mois du système calendaire actuel. Le premier élément de la liste correspond au nom du premier mois de l’année.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

getTimeStyle Obtient le style d’heure de cette occurrence de DateTimeFormatter.Chaîne de style d’heure de cet outil de formatage.

Valeurs possibles :

DateTimeStyle.LONG
DateTimeStyle.MEDIUM
DateTimeStyle.SHORT
DateTimeStyle.NONE
DateTimeStyle.CUSTOM

String Obtient le style d’heure de cette occurrence de DateTimeFormatter. Le style permet d’extraire un modèle de formatage d’heure prédéfini du système d’exploitation. La valeur de style d’heure peut être définie par le constructeurDateTimeFormatter(), la méthode setDateTimeStyles() ou la méthode setDateTimePattern().

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

getWeekdayNames Extrait une liste de chaînes localisées contenant le nom des jours de la semaine du système calendaire actuel.si le paramètre nameStyle ou context est défini sur null. TypeErrorTypeErrorVecteur de chaînes localisées contenant le nom des mois pour les paramètres régionaux, le nom du style et le contexte spécifiés. Le premier élément du vecteur, à l’index 0, correspond au nom pour dimanche ; l’élément suivant correspond au nom pour lundi, et ainsi de suite. nameStyleStringfullIndique la chaîne de style de nom à utiliser. Les valeurs possibles sont :

DateTimeNameStyle.FULL
DateTimeNameStyle.LONG_ABBREVIATION
DateTimeNameStyle.SHORT_ABBREVIATION

contextStringstandaloneCode indiquant le contexte d’utilisation de la la chaîne formatée. Ce contexte s’applique uniquement à certains paramètres régionaux dans lesquels le nom du mois change selon le contexte. Par exemple, en grec les noms de mois diffèrent selon qu’ils sont affichés seuls ou accompagnés d’un jour. Valeurs valides :

DateTimeNameContext.FORMAT
DateTimeNameContext.STANDALONE

Extrait une liste de chaînes localisées contenant le nom des jours de la semaine du système calendaire actuel. Le premier élément dans la liste représente le nom pour dimanche.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

setDateTimePattern Définit la chaîne modèle utilisée par cet objet DateTimeFormatter pour formater la date et l’heure.si le paramètre pattern est défini sur null. TypeErrorTypeErrorpatternString Définit la chaîne modèle utilisée par cet objet DateTimeFormatter pour formater la date et l’heure.

Le modèle utilisé pour formater les dates peut être définis de l’une des trois façons suivantes :

Via les paramètres dateStyle et timeStyle utilisés dans le constructeur
Via la méthode setDateTimeStyles()
Via la méthode setDateTimePattern().

Cette méthode a également pour effet de remplacer les styles de date et d’heure actuellement définis pour cet objet DateTimeFormatter par la valeur DateTimeStyle.CUSTOM.

Une chaîne de modèle définit la façon dont la date et l’heure sont formatées. Le modèle contient des séquences de lettres qui sont remplacées par les valeurs de date et d’heure dans la chaîne formatée. Par exemple, dans le modèle « yyyy/MM », les caractères « yyyy » sont remplacés par une année à quatre chiffres suivie du caractère « / », et les caractères « MM » sont remplacés par un mois à deux chiffres.

Il est possible de répéter plusieurs fois la plupart des lettres utilisées dans les modèles en vue d’obtenir différents résultats, comme décrit dans le tableau ci-dessous.

Si une séquence dépasse le nombre maximum de lettres pris en charge par un modèle, elle est à nouveau associée à la séquence la plus longue correspondant à la lettre de ce modèle. Par exemple :

MMMMMM est remplacée par MMMM
dddd est remplacée par dd
EEEEEEE est remplacée par EEEE
aa est remplacée par a
hhh est remplacée par hh
mmmm est remplacée par mm

En théorie, un modèle peut contenir jusqu’à 255 caractères. Toutefois, certaines plates-formes imposent une limite stricte. Si le modèle dépasse la limite de caractères, la propriété lastOperationStatus est définie sur la valeur LastOperationStatus.PATTERN_SYNTAX_ERROR.

Tous les systèmes d’exploitation ne prennent pas en charge tous les modèles. Si un modèle n’est pas pris en charge sur la plate-forme, un modèle de substitution est alors utilisé et la propriété lastOperationStatus est définie de façon à indiquer le recours à un modèle de substitution. S’il s’avère impossible de fournir un modèle de substitution valable, une chaîne vide est utilisée et la propriété lastOperationStatus est définie de façon à indiquer que le modèle n’est pas pris en charge.

Le tableau suivant décrit les lettres de modèle valides, ainsi que leur signification.

Lettre de modèleDescriptionGEre. Remplacez la chaîne Ere par la date et le calendrier actuels. Ce modèle n’est pas pris en charge sur tous les systèmes d’exploitation. Sur les systèmes d’exploitation qui ne prennent pas en charge l’ère, les lettres du modèle d’entrée sont remplacées par une chaîne vide.

Le modèle d’ère peut comporter de une à cinq lettres, interprétées de la façon suivante :

Si le modèle contient de une à trois lettres, la forme abrégée est utilisée.
Si le modèle contient quatre lettres, le format est interprété en tant que forme complète.
Si le modèle contient cinq lettres, le format est interprété en tant qu’abréviation courte.

Exemples de calendrier grégorien (pour les systèmes d’exploitation qui prennent en charge ce modèle) :

G, GG, GGG = AD
GGGG = Anno Domini
GGGGG = A

yAnnée. Si le modèle contient deux lettres, les deux derniers chiffres de l’année s’affichent ; autrement, le nombre de lettres détermine le nombre de chiffres. Si la valeur de l’année nécessite plus de chiffres que ceux fournis par le nombre de lettres, la valeur d’année complète est fournie. S’il y a plus de lettres que celles requises par la valeur, les valeurs de l’année sont complétées par des zéros. La liste suivante indique les résultats pour les années 1 et 2005.

Exemples :

y = 1
y = 2005
yy = 01
yy = 05
yyyy = 0001 ou 01, en fonction du système d’exploitation.
yyyy = 2005
yyyy = 0001 ou 01, en fonction du système d’exploitation. Si la valeur de l’année comporte plus de quatre « y », le nombre de chiffres maximal pris en charge sur le système d’exploitation est pris en compte.
yyyyy = 2005

M Mois de l’année. Le modèle de mois peut comporter de une à cinq lettres, interprétées de la façon suivante :

Si le modèle contient une lettre, le format est interprété en tant que valeur numérique à un ou deux chiffres.
Si le modèle contient deux lettres, le format est interprété en tant que valeur numérique à deux chiffres.
Si le modèle contient trois lettres, le format est interprété en tant qu’abréviation longue.
Si le modèle contient quatre lettres, le format est interprété en tant que nom complet.
Si le modèle contient cinq lettres, le format est interprété en tant qu’abréviation courte. Ce format n’est pas pris en charge sur tous les systèmes d’exploitation ; le cas échéant, l’abréviation longue est utilisée par défaut.

Exemples :

M = 7
MM = 07
MMM = 7 juil月
MMMM = 7 juil月
MMMMM = J ou 7 juil, 7 ou 7日 selon le système d’exploitation.

d Jour du mois. Les modèles du jour du mois peuvent comporter une ou deux lettres, interprétées comme suit :

Si le modèle contient une lettre, le format est interprété en tant que valeur numérique à un ou deux chiffres.
Si le modèle contient deux lettres, le format est interprété en tant que valeur numérique à deux chiffres.

Exemples :

d = 4
dd = 04
dd = 14

EJour de la semaine. Les modèles du jour de la semaine peuvent comporter de une à cinq lettres, interprétées de la façon suivante :

Si le modèle contient de une à trois lettres, le format est interprété en tant qu’abréviation longue.
Si le modèle contient quatre lettres, le format est interprété en tant que nom complet.
Si le modèle contient cinq lettres, le format est interprété en tant qu’abréviation courte. Ce format n’est pas pris en charge sur tous les systèmes d’exploitation ; le cas échéant, l’abréviation longue est utilisée par défaut.

Exemples :

E, EE, EEE = Mar
EEEE = Mardi
EEEEE = M ou Mardi selon le système d’exploitation.

QTrimestre. Certaines plates-formes ne prennent pas en charge ce modèle. Les modèles de trimestre peuvent comporter de une à quatre lettres, interprétées de la façon suivante :

Si le modèle contient une lettre, le format est interprété en tant que valeur numérique à un chiffre.
Si le modèle contient deux lettres, le format est interprété en tant que valeur numérique à deux chiffres.
Si le modèle contient trois lettres, le format est interprété en tant qu’abréviation.
Si le modèle contient quatre lettres, le format est interprété en tant que nom complet.

Exemples (pour les systèmes d’exploitation qui prennent en charge ce modèle) :

Q = 2
QQ = 02
QQQ = T2
QQQQ = deuxième trimestre

wSemaine de l’année. Certaines plates-formes ne prennent pas en charge ce modèle. Ce modèle peut comporter de une à deux lettres, interprétées de la façon suivante :

Si le modèle contient une lettre, le format est interprété en tant que valeur numérique à un ou deux chiffres.
Si le modèle contient deux lettres, le format est interprété en tant que valeur numérique à deux chiffres.

Exemples pour la deuxième semaine de l’année (pour les systèmes d’exploitation qui prennent en charge ce modèle) :

w = 2
ww = 02

WSemaine du mois. Certaines plates-formes ne prennent pas en charge ce modèle. Ce modèle ne permet d’utiliser qu’une lettre.

Exemples pour la deuxième semaine du mois de juillet (pour les systèmes d’exploitation qui prennent en charge ce modèle) :

W = 2

DJour de l’année. Certaines plates-formes ne prennent pas en charge ce modèle. Ce modèle peut comporter de une à trois lettres.

Exemples pour le deuxième jour de l’année (pour les systèmes d’exploitation qui prennent en charge ce modèle) :

D = 2
DD = 02
DDD = 002

FOccurrence d’un jour de la semaine dans le mois d’un calendrier. Par exemple, cet élément affiche « 3 » s’il est utilisé pour formater la date correspondant au troisième lundi du mois d’octobre. Ce modèle ne permet d’utiliser qu’une lettre.

Exemples pour le deuxième mercredi du mois de juillet (pour les systèmes d’exploitation qui prennent en charge ce modèle) :

F = 2

aIndicateur am/pm. Ce modèle ne permet d’utiliser qu’une lettre, a ou p.

Exemples :

a = AM, 午前
p = PM, 午後

hHeure du jour au format 12 heures [1 - 12]. Ce modèle doit comporter une ou deux lettres.

Exemples :

h = 1
h = 12
hh = 01

HHeure du jour au format 24 heures [0 - 23]. Ce modèle doit comporter une ou deux lettres.

Exemples :

H = 0
H = 23
HH = 00

KHeure du jour au format 12 heures [0 - 11]. Ce modèle doit comporter une ou deux lettres. Ce modèle n’est pas pris en charge sur tous les systèmes d’exploitation.

Exemples (pour les systèmes d’exploitation qui prennent en charge ce modèle) :

K = 0
K = 11
KK = 00

kHeure du jour au format 24 heures [1 - 24]. Ce modèle doit comporter une ou deux lettres. Ce modèle n’est pas pris en charge sur tous les systèmes d’exploitation.

Exemples (pour les systèmes d’exploitation qui prennent en charge ce modèle) :

k = 1
k = 24
kk = 01

mMinutes de l’heure [0 - 59]. Ce modèle doit comporter une ou deux lettres.

Exemples :

m = 2
m = 59
mm = 02

sSecondes dans la minute [0 - 59]. Ce modèle doit comporter une ou deux lettres.

Exemples :

s = 2
s = 59
ss = 02

SMillisecondes. Ce modèle doit comporter de une à cinq lettres. La valeur est arrondie en fonction du nombre de lettres utilisées. Lors de l’utilisation de cinq caractères (SSSSS), les fractions de millisecondes sont indiquées.

Exemples :

S = 2
SS = 24
SSS = 235
SSSS = 2350
SSSSS = 23500

zTime Zone. Représente le fuseau horaire en tant que chaîne qui respecte l’heure standard ou l’heure d’été, sans faire référence à un emplacement spécifique. Ce modèle n’est pas pris en charge sur tous les systèmes d’exploitation. Sur les systèmes d’exploitation qui ne prennent pas en charge les modèles de fuseau horaire, les lettres du modèle d’entrée sont remplacées par une chaîne vide. Sur les systèmes d’exploitation qui ne prennent pas en charge ce modèle, tous les paramètres régionaux ne disposent pas d’une chaîne définie. Ces paramètres régionaux sont définis sur un format GMT localisé, tel que GMT-08:00 ou GW-08:00.

Ce modèle de fuseau horaire doit comporter de une à quatre lettres, interprétées comme suit :

Si le modèle contient trois lettres, le format est interprété en tant que forme abrégée.
Si le modèle contient quatre lettres, le format est interprété en tant que nom complet.

Exemples (pour les systèmes d’exploitation qui prennent en charge ce format) :

z, zz, zzz = PDT
z, zz, zzz = PST
z, zz, zzz = GMT-0800
zzzz = Pacific Daylight Time
zzzz = Pacific Standard Time

ZTime Zone. Représente le fuseau horaire en tant que décalage à partir du temps GMT. Ce modèle n’est pas pris en charge sur tous les systèmes d’exploitation. Sur les systèmes d’exploitation qui ne prennent pas en charge les modèles de fuseau horaire, les lettres du modèle d’entrée sont remplacées par une chaîne vide.

Ce modèle de fuseau horaire doit comporter de une à quatre lettres, interprétées comme suit :

Si le modèle contient de une à trois lettres, le format utilisé est RFC 822.
Si le modèle contient quatre lettres, le format utilisé est le format GMT localisé. Le format GMT non localisé est défini par défaut pour les paramètres régionaux ne disposant pas d’un format GMT localisé.

Exemples (pour les systèmes d’exploitation qui prennent en charge ce format) :

Z, ZZ, ZZZ = -0800
ZZZZ = GMT-08:00, GW-08:00

vTime Zone. Chaîne reflétant le fuseau horaire générique qui ne fait pas référence à un emplacement spécifique ou qui ne fait pas la différence entre l’heure d’été et l’heure standard. Ce modèle n’est pas pris en charge sur tous les systèmes d’exploitation. Sur les systèmes d’exploitation qui ne prennent pas en charge les modèles de fuseau horaire, les lettres du modèle d’entrée sont remplacées par une chaîne vide. Sur les systèmes d’exploitation qui prennent en charge ce modèle, des chaînes de substitution sont fournies si un nom localisé n’est pas disponible.

Ce modèle de fuseau horaire doit comporter de une à quatre lettres, interprétées comme suit :

Si le modèle contient une lettre, le format utilise la forme abrégée.
Si le modèle contient quatre lettres, le format utilise la forme complète.

Exemples (pour les systèmes d’exploitation qui prennent en charge ce format) :

v = PT
vvvv = Pacific Time

’Autre texte’Il est possible d’ajouter du texte et des signes de ponctuation dans la chaîne du modèle. Toutefois, les caractères de a à z et de A à Z sont réservés aux caractères de syntaxe et doivent être placés entre guillemets simples lorsqu’ils sont insérés dans la chaîne formatée. Pour inclure un guillemet simple dans la chaîne de résultat, deux guillemets simples doivent être utilisés dans la chaîne de modèle. Les deux guillemets simples peuvent apparaître à l’intérieur ou à l’extérieur d’une partie entre guillemets de la chaîne de modèle. Une paire de guillemets simples non concordants est ajoutée à la fin de la chaîne.

Exemples :

EEEE, MMM. d, yyyy ’à’ h ’pile’ p= Mardi, 8 sept. 2005 à 1 h pile de l’après-midi
yyyy年M月d日 = 2005年9月8日
mm’’ss’’ = 43’01’

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

setDateTimeStyles Définit les styles de date et d’heure pour cette occurrence de DateTimeFormatter.si le paramètre dateStyle ou timeStyle n’est pas une constante DateTimeStyle valide. ArgumentErrorArgumentErrorsi le paramètre dateStyle ou timeStyle est défini sur null. TypeErrorTypeErrordateStyleStringSpécifie le style à utiliser lors du formatage des dates. La valeur correspond à l’une des valeurs énumérées par la classe DateTimeStyle :

DateTimeStyle.LONG
DateTimeStyle.MEDIUM
DateTimeStyle.SHORT
DateTimeStyle.NONE

timeStyleStringSpécifie le style à utiliser lors du formatage des heures. La valeur correspond à l’une des valeurs énumérées par la classe DateTimeStyle :

DateTimeStyle.LONG
DateTimeStyle.MEDIUM
DateTimeStyle.SHORT
DateTimeStyle.NONE

Définit les styles de date et d’heure pour cette occurrence de DateTimeFormatter. Les styles de date et d’heure permettent de définir les modèles de formatage de date et d’heure sur les modèles prédéfinis en fonction des paramètres régionaux à partir du système d’exploitation. Cette méthode remplace les styles définis à l’aide du constructeur DateTimeFormatter() ou à l’aide de la méthode setDateTimePattern(). Le modèle de date et d’heure est également mis à jour en fonction des styles définis.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

actualLocaleIDName Nom de l’ID de paramètres régionaux actuel utilisé par cet objet DateTimeFormatter.String Nom de l’ID de paramètres régionaux actuel utilisé par cet objet DateTimeFormatter.

Il existe trois possibilités pour la valeur du nom, en fonction du système d’exploitation et de la valeur du paramètre requestedLocaleIDName transmis au constructeur Collator().

Si les paramètre régionaux requis n’étaient pas définis sur LocaleID.DEFAULT et que le système d’exploitation les prend en charge, le nom renvoyé est identique à la propriété requestedLocaleIDName.
Si LocaleID.DEFAULT a été utilisée comme valeur pour le paramètre requestedLocaleIDName transmis au constructeur, le nom des paramètres régionaux spécifié par le système d’exploitation de l’utilisateur est utilisé. La valeur LocaleID.DEFAULT préserve le paramètre personnalisé de l’utilisateur dans le système d’exploitation. La transmission d’une valeur explicite en tant que paramètre requestedLocaleIDName ne produit pas nécessairement le même résultat que l’utilisation de LocaleID.DEFAULT, même si le nom des deux identificateurs de paramètres régionaux est identique. Il est possible que l’utilisateur ait personnalisé les paramètres régionaux sur son ordinateur ; or, si vous demandez un identificateur de paramètres régionaux explicite au lieu d’utiliser LocaleID.DEFAULT, votre application ne récupérera pas ces paramètres personnalisés.

Par exemple :
var fmt:DateTimeFormatter = new DateTimeFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName;
Dans l’exemple ci-dessus, aliName représente le nom des paramètres régionaux correspondant aux paramètres définis par l’utilisateur dans le système d’exploitation actuel (par exemple, "it-IT" si les paramètres régionaux de l’utilisateur sont définis sur Italien (Italie)) et non "i-default" (nom du paramètre LocaleID.DEFAULT).
Si le système ne prend pas en charge le paramètre requestedLocaleIDName spécifié dans le constructeur, un nom d’ID de paramètres régionaux par défaut est fourni.

Par exemple :
var fmt:DateTimeFormatter = new DateTimeFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName;
Si le système d’exploitation dans l’exemple ci-dessus ne prend pas en charge l’ID de paramètres régionaux "fr_CA", c’est-à-dire Français (Canada), des paramètres de substitution sont fournis. Dans ce cas, l’ID de paramètres régionaux par défaut est "fr-FR", c’est-à-dire Français (France).

lastOperationStatus Etat de dernière opération que cet objet DateTimeFormatter a effectuée.String Etat de dernière opération que cet objet DateTimeFormatter a effectuée. La propriété lastOperationStatus est définie chaque fois que le constructeur ou une méthode de cette classe est appelé(e), ou qu’une autre propriété est définie. Pour les valeurs disponibles, voir la description de chaque méthode. requestedLocaleIDName Nom de l’ID de paramètres régionaux requis ayant été transmis au constructeur de cet objet DateTimeFormatter.String Nom de l’ID de paramètres régionaux requis ayant été transmis au constructeur de cet objet DateTimeFormatter.

Si la valeur LocaleID.DEFAULT a été utilisée, le nom renvoyé est "i-default". Les paramètres régionaux actuels peuvent différer des paramètres régionaux requis lorsque des paramètres régionaux par défaut sont appliqués. Il est possible de récupérer le nom du paramètre régional actuel à l’aide de la propriété actualLocaleIDName.

LastOperationStatus La classe LastOperationStatus énumère les valeurs constantes qui représentent l’état de l’opération de service de globalisation la plus récente.Object La classe LastOperationStatus énumère les valeurs constantes qui représentent l’état de l’opération de service de globalisation la plus récente. Ces valeurs peuvent être récupérées via la propriété en lecture seule lastOperationStatus disponible dans la plupart des classes de globalisation. BUFFER_OVERFLOW_ERROR Indique que la mémoire tampon fournie ne dispose pas de suffisamment d’espace pour contenir les résultats.bufferOverflowErrorString Indique que la mémoire tampon fournie ne dispose pas de suffisamment d’espace pour contenir les résultats. ERROR_CODE_UNKNOWN Indique que le code d’erreur renvoyé est inconnu.errorCodeUnknownString Indique que le code d’erreur renvoyé est inconnu. Toute méthode non statique ou propriété accessible en lecture/écriture peut renvoyer cette erreur lorsque l’opération a échoué et que le code d’erreur renvoyé est inconnu. ILLEGAL_ARGUMENT_ERROR Indique qu’un argument transmis à une méthode était incorrect.illegalArgumentErrorString Indique qu’un argument transmis à une méthode était incorrect.

Par exemple, le code suivant indique qu’un état d’erreur d’argument non valide est défini lorsque la propriété CurrencyFormatter.grouping est définie sur la valeur non valide "3;".

var cf:CurrencyFormatter = new CurrencyFormatter("en-US"); cf.groupingPattern = "3;"; trace(cf.lastOperationStatus); // "illegalArgumentError" INDEX_OUT_OF_BOUNDS_ERROR Indique qu’un itérateur a dépassé les limites ou qu’un paramètre non valide a été spécifié pour le mois, le jour ou l’heure.indexOutOfBoundsErrorString Indique qu’un itérateur a dépassé les limites ou qu’un paramètre non valide a été spécifié pour le mois, le jour ou l’heure. INVALID_ATTR_VALUE Indique que la valeur d’un attribut donné est en dehors de la plage attendue.invalidAttrValueString Indique que la valeur d’un attribut donné est en dehors de la plage attendue.

L’exemple suivant indique que définir la propriété NumberFormatter.negativeNumberFormat sur une valeur qui se trouve en dehors de la plage attendue entraîne un état de valeur d’attribut non valide.

var nf:NumberFormatter = new NumberFormatter(LocaleID.DEFAULT); nf.negativeNumberFormat = 9; nf.lastOperationStatus; // "invalidAttrValue" INVALID_CHAR_FOUND Indique qu’une valeur Unicode non valide a été détectée.invalidCharFoundString Indique qu’une valeur Unicode non valide a été détectée. MEMORY_ALLOCATION_ERROR Indique que l’allocation de mémoire a échoué.memoryAllocationErrorString Indique que l’allocation de mémoire a échoué. NO_ERROR Indique que la dernière opération s’est déroulée sans aucune erreur.noErrorString Indique que la dernière opération s’est déroulée sans aucune erreur. Cet état peut être renvoyé par tous les constructeurs, méthodes non statiques, méthodes statiques et propriétés accessibles en lecture/écriture. NUMBER_OVERFLOW_ERROR Indique qu’une opération a produit une valeur qui dépasse le type numérique spécifié.numberOverflowErrorString Indique qu’une opération a produit une valeur qui dépasse le type numérique spécifié. PARSE_ERROR Indique que l’analyse d’un numéro a échoué.parseErrorString Indique que l’analyse d’un numéro a échoué. Il est possible de renvoyer cet état en analysant les méthodes des classes de formatage, telles que CurrencyFormatter.parse() et NumberFormatter.parseNumber(). Par exemple, si la valeur "12abc34" est transmise en tant que paramètre à la méthode CurrencyFormatter.parse(), la méthode renvoie "NaN" et définit la valeur lastOperationStatus sur LastOperationStatus.PARSE_ERROR. PATTERN_SYNTAX_ERROR Indique que le modèle de formatage d’un numéro, d’une date ou d’une heure n’est pas valide.patternSyntaxErrorString Indique que le modèle de formatage d’un numéro, d’une date ou d’une heure n’est pas valide. Cet état est défini lorsque le système d’exploitation de l’utilisateur ne prend pas en charge le modèle donné.

Par exemple, le code suivant affiche la valeur de la propriété lastOperationStatus après l’utilisation d’un modèle de formatage "xx" non valide :

var df:DateTimeFormatter = new DateTimeFormatter("en-US"); df.setDateTimePattern("xx"); trace(df.lastOperationStatus); // "patternSyntaxError" PLATFORM_API_FAILED Indique que l’API d’une plate-forme sous-jacente a échoué pour une opération.platformAPIFailedString Indique que l’API d’une plate-forme sous-jacente a échoué pour une opération. TRUNCATED_CHAR_FOUND Indique qu’un caractère Unicode tronqué a été détecté.truncatedCharFoundString Indique qu’un caractère Unicode tronqué a été détecté. UNEXPECTED_TOKEN Indique qu’un jeton inattendu a été détecté dans la chaîne d’un identificateur de paramètres régionaux.unexpectedTokenString Indique qu’un jeton inattendu a été détecté dans la chaîne d’un identificateur de paramètres régionaux.

Par exemple, le code suivant affiche la valeur de la propriété lastOperationStatus après l’utilisation d’une chaîne incomplète lors de la demande d’un identificateur de paramètres régionaux. Par conséquent, la propriété lastOperationStatus est définie sur la valeur UNEXPECTED_TOKEN après un appel à la méthode LocaleID.getKeysAndValues().

var locale:LocaleID = new LocaleID("en-US@Collation"); var kav:Object = locale.getKeysAndValues(); trace(locale.lastOperationStatus); // "unexpectedToken" UNSUPPORTED_ERROR Indique que l’opération ou l’option requise n’est pas prise en charge.unsupportedErrorString Indique que l’opération demandée ou option n’est pas pris en charge. Cet état peut être renvoyé par des méthodes telles que DateTimeFormatter.setDateTimePattern() et lors de la récupération de propriétés telles que Collator.ignoreCase. USING_DEFAULT_WARNING Indique qu’une valeur par défaut du système d’exploitation a été utilisée au cours de la dernière opération.usingDefaultWarningString Indique qu’une valeur par défaut du système d’exploitation a été utilisée au cours de la dernière opération. Les constructeurs de classe peuvent renvoyer cet état. USING_FALLBACK_WARNING Indique qu’une valeur par défaut a été définie au cours de la dernière opération.usingFallbackWarningString Indique qu’une valeur par défaut a été définie au cours de la dernière opération. Cet état peut être renvoyé par des constructeurs et des méthodes tels que DateTimeFormatter.setDateTimeStyles(), et lors de la récupération de propriétés telles que CurrencyFormatter.groupingPattern. NationalDigitsType La classe NationalDigitsType énumère les constantes qui indiquent les jeux de chiffres utilisés par la classe NumberFormatter.Object La classe NationalDigitsType énumère les constantes qui indiquent les jeux de chiffres utilisés par la classe NumberFormatter. La valeur de chaque constante représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres décimaux spécifié. ARABIC_INDIC Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres arabe-hindi.0x0660uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres arabe-hindi. BALINESE Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres balinais.0x1B50uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres balinais. BENGALI Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres bengali.0x09E6uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres bengali. CHAM Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres cham.0xAA50uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres cham. DEVANAGARI Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres dévanâgari.0x0966uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres dévanâgari. EUROPEAN Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres latin-1 (européen).0x0030uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres latin-1 (européen). EXTENDED_ARABIC_INDIC Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres arabe-hindi étendu.0x06F0uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres arabe-hindi étendu. FULL_WIDTH Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres pleine chasse.0xFF10uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres pleine chasse. GUJARATI Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres gujarati.0x0AE6uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres gujarati. GURMUKHI Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres gurmukhi.0x0A66uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres gurmukhi. KANNADA Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres kannada.0x0CE6uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres kannada. KAYAH_LI Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres kayah Li.0xA900uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres kayah Li. KHMER Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres khmer.0x17E0uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres khmer. LAO Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres laotien.0x0ED0uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres laotien. LEPCHA Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres lepcha.0x1C40uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres lepcha. LIMBU Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres limbu.0x1946uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres limbu. MALAYALAM Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres malayalam.0x0D66uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres malayalam. MONGOLIAN Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres mongolien.0x1810uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres mongolien. MYANMAR_SHAN Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres myanmar shan.0x1090uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres myanmar shan. MYANMAR Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres myanmar.0x1040uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres myanmar. NEW_TAI_LUE Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres taï lü.0x19D0uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres taï lü. NKO Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres nko.0x07C0uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres nko. OL_CHIKI Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres OI chiki.0x1C50uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres OI chiki. ORIYA Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres oriya.0x0B66uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres oriya. OSMANYA Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres osmanais.0x104A0uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres osmanais. SAURASHTRA Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres saurachtra.0xA8D0uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres saurachtra. SUNDANESE Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres sundanais.0x1BB0uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres sundanais. TAMIL Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres tamoul.0x0BE6uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres tamoul. TELUGU Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres télougou.0x0C66uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres télougou. THAI Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres thaï.0x0E50uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres thaï. TIBETAN Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres tibétain.0x0F20uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres tibétain. VAI Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres vaï.0xA620uint Représente la valeur Unicode correspondant au chiffre zéro dans le jeu de chiffres vaï. CurrencyParseResult Structure de données qui représente une chaîne de montants en devise et de symboles de devise ou une chaîne extraite suite à l’analyse d’une valeur monétaire.Object Structure de données qui représente une chaîne de montants en devise et de symboles de devise ou une chaîne extraite suite à l’analyse d’une valeur monétaire. CurrencyParseResult Construit un objet de résultat d’analyse de devises.valueNumberunknownNombre représentant la valeur du montant en devise. symbolStringChaîne représentant le symbole de devise. Construit un objet de résultat d’analyse de devises. currencyString Portion de la chaîne d’entrée qui correspond au symbole ou à la chaîne de devise.String Portion de la chaîne d’entrée qui correspond au symbole ou à la chaîne de devise. value Valeur du montant en devise ayant été extraite de la chaîne d’entrée.Number Valeur du montant en devise ayant été extraite de la chaîne d’entrée. NumberParseResult Structure de données qui contient des informations sur un nombre ayant été extrait suite à l’analyse d’une chaîne.Object Structure de données qui contient des informations sur un nombre ayant été extrait suite à l’analyse d’une chaîne.

La chaîne numérique peut contenir un préfixe et un suffixe autour d’un nombre. Dans ce cas, la propriété startIndex est définie sur le premier caractère du nombre. Par ailleurs, la propriété endIndex est définie à l’index du caractère qui suit le dernier caractère du nombre.

NumberParseResult Construit un résultat d’analyse de nombres. valueNumberunknownValeur de la partie numérique de la chaîne d’entrée. startIndexint0x7fffffffIndex du premier caractère du nombre dans la chaîne d’entrée. endIndexint0x7fffffffIndex du caractère qui suit le dernier caractère du nombre dans la chaîne d’entrée. Construit un résultat d’analyse de nombres. Les objets NumberParseResult sont généralement créés par les méthodes NumberFormatter.parse() et NumberFormatter.parseNumber(), et non par l’appel direct de ce constructeur. endIndex Index du caractère qui suit le dernier caractère de la partie numérique de la chaîne d’entrée.int Index du caractère qui suit le dernier caractère de la partie numérique de la chaîne d’entrée. startIndex Index du premier caractère de la partie numérique de la chaîne d’entrée.int Index du premier caractère de la partie numérique de la chaîne d’entrée. value Valeur de la partie numérique de la chaîne d’entrée.Number Valeur de la partie numérique de la chaîne d’entrée. LocaleID La classe LocaleID fournit des méthodes en vue d’analyser et d’utiliser les noms des identificateurs de paramètres régionaux.Object La classe LocaleID fournit des méthodes en vue d’analyser et d’utiliser les noms des identificateurs de paramètres régionaux. Cette classe prend en charge les noms des identificateurs de paramètres régionaux qui utilisent la syntaxe définie par la norme technique Unicode nº 35 (http://unicode.org/reports/tr35/). L’exemple suivant montre comment récupérer et afficher des informations sur les chaînes LocaleID pour différents paramètres régionaux.

Cet exemple utilise les paramètres régionaux suivants : Arabe (Arabie Saoudite), Anglais (Etats-Unis), Anglais (Etats-Unis, variante POXIS), Chinois (PRC), Chinois (Taiwan), Chinois (Han simplifié), Chinois (PRC avec plusieurs clés et valeurs).

Cet exemple effectue les opérations suivantes pour chaque jeu de paramètres régionaux dans la liste :

Crée un nouvel objet LocaleID.
Affiche plusieurs propriétés de l’objet LocaleID. Les valeurs indiquées diffèrent en fonction du système d’exploitation et des préférences de l’utilisateur.
Affiche le jeu complet de touches et valeurs pour l’objet LocaleID.

package { import flash.display.Sprite; import flash.globalization.LocaleID; public class LocaleIDExample extends Sprite { public function LocaleIDExample() { var localeNames:Array = ["ar-SA", "EN_us", "en-US-POSIX", "zh-CH", "zh-TW", "zh-Hans", "zh-CH@collation=pinyin;calendar=chinese;currency=RMB"]; for ( var i:int = 0; i < localeNames.length; i++ ) { var locID:LocaleID = new LocaleID( localeNames[i] as String ); trace('\n\n' + "LocaleID requested: " + locID.requestedLocaleIDName + "; actual: " + locID.actualLocaleIDName); trace( "Last Operation Status after new LocaleID: " + locID.lastOperationStatus); trace("name: " + locID.name); trace("language: " + locID.getLanguage() + "; status: " + locID.lastOperationStatus); trace("script: " + locID.getScript() + "; status: " + locID.lastOperationStatus); trace("region: " + locID.getRegion() + "; status: " + locID.lastOperationStatus); trace("variant: " + locID.getVariant() + "; status: " + locID.lastOperationStatus); trace("isRightToLeft: ", locID.isRightToLeft(), "; status: " + locID.lastOperationStatus); var keysAndValues:Object = locID.getKeysAndValues(); var key:String; for (key in keysAndValues) { trace("key: ", key + " value: " + keysAndValues[ key ]); } trace( "Last Operation Status after getKeysAndValues(): " + locID.lastOperationStatus); } } } } LocaleID Construit un nouvel objet LocaleID en fonction du nom d’un paramètre régional.si le nom est null. ArgumentErrorArgumentErrornameStringNom d’un l’ID de paramètres régionaux, pouvant inclure une chaîne de classement facultative. Par exemple : "en-US" ou "de-DE@collation=phonebook" Construit un nouvel objet LocaleID en fonction du nom d’un paramètre régional. Le nom du paramètre régional doit être conforme à la syntaxe définie par la norme technique Unicode nº 35 (http://unicode.org/reports/tr35/).

Lorsque le constructeur se termine avec succès, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Lorsque le nom de l’identificateur de paramètres régionaux requis n’est pas disponible, la propriété lastOperationStatus est définie sur l’une des valeurs suivantes :

LastOperationStatus.USING_FALLBACK_WARNING
LastOperationStatus.USING_DEFAULT_WARNING

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

determinePreferredLocales Renvoie une liste de paramètres régionaux acceptables basée sur une liste de paramètres régionaux souhaitables et sur une liste des paramètres régionaux actuellement disponibles.Sous-ensemble de paramètres régionaux disponibles, classés selon les préférences de l’utilisateur. wantListe des paramètres régionaux préférés de l’utilisateur, classés par ordre de préférence. haveListe des paramètres régionaux disponibles dans l’application. L’ordre de cette liste n’est pas important. keywordStringuserinterfaceMot-clé à utiliser pour vous aider à déterminer le meilleur ajustement. Renvoie une liste de paramètres régionaux acceptables basée sur une liste de paramètres régionaux souhaitables et sur une liste des paramètres régionaux actuellement disponibles.

La liste résultante est classée par ordre de préférence.

Voici un exemple d’usage courant de cette méthode :

Un utilisateur spécifie une liste de langues qu’il comprend (enregistrée dans un profil utilisateur, un navigateur ou un cookie). L’utilisateur répertorie en premier les langues qu’il comprend le mieux ; l’ordre de classement des langues dans la liste est donc important. Il s’agit de la liste "want" (souhaitée).
L’application est localisée dans un certain nombre de langues. Il s’agit de la liste "have" (réelle).
La méthode determinePreferredLocales() renvoie une intersection des deux listes, classée de façon à ce que les langues préférées de l’utilisateur apparaissent en premier.

Si cette fonction n’est pas prise en charge sur le système d’exploitation actuel, cette méthode renvoie une valeur nulle.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

getKeysAndValues Renvoie un objet contenant toutes les paires clé-valeur de l’objet LocaleID.Objet contenant toutes les clés et les valeurs de l’objet LocaleID, structuré comme un tableau associatif ou une table de hachage. Object Renvoie un objet contenant toutes les paires clé-valeur de l’objet LocaleID.

L’objet renvoyé est structuré comme une table de hachage ou un tableau associatif, où chaque nom de propriété représente une clé, et où la valeur de la propriété représente la valeur de cette clé. Par exemple, le code suivant répertorie toutes les clés et les valeurs transmises via l’objet LocaleID à l’aide de la méthode getKeysAndValues() :

var myLocale:LocaleID = new LocaleID("fr-CA"); var localeData:Object = myLocale.getKeysAndValues(); for (var propertyName:String in localeData) { trace(propertyName + " = " + localeData[propertyName]); }

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

getLanguage Renvoie le code de langue spécifié par le nom de l’ID de paramètres régionaux.Code de langue à deux caractères obtenu suite à l’analyse du nom de l’ID de paramètres régionaux. String Renvoie le code de langue spécifié par le nom de l’ID de paramètres régionaux.

S’il s’avère impossible d’analyser correctement le nom du paramètre régional, le code de langue est alors identique au nom complet du paramètre régional.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

getRegion Renvoie le code de région spécifié par le nom de l’ID de paramètres régionaux.Code de région à deux caractères, ou chaîne vide s’il est impossible d’analyser le code de région ou de le déduire des paramètres régionaux. String Renvoie le code de région spécifié par le nom de l’ID de paramètres régionaux.

Cette méthode renvoie une chaîne vide s’il s’avère impossible d’analyser ou de deviner le code de région, notamment si un nom d’ID de paramètres régionaux inconnu ou incomplet (par exemple, "xy") est utilisé. Le code de région n’est pas validé en fonction d’une liste. Par exemple, le code de région renvoyé pour un nom d’ID de paramètres régionaux tel que "xx-yy" est "YY".

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Si la région ne fait pas partie du nom du paramètre régional spécifié, le code de région le plus ressemblant est « deviné », et la propriété lastOperationStatus est définie sur LastOperationStatus.USING_FALLBACK_WARNING.

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

getScript Renvoie le code de script spécifié par le nom de l’ID de paramètres régionaux.Code de région à deux caractères, ou chaîne vide s’il est impossible d’analyser le code de région ou de le déduire des paramètres régionaux. String Renvoie le code de script spécifié par le nom de l’ID de paramètres régionaux.

Cette méthode renvoie une chaîne vide s’il s’avère impossible d’analyser ou de deviner le code de région, notamment si un nom d’ID de paramètres régionaux inconnu ou incomplet (par exemple, "xy") est utilisé. Le code de script n’est pas validé en fonction d’une liste. Par exemple, le code de script renvoyé pour un nom d’ID de paramètres régionaux tel que "xx-Abcd-YY" est "Abcd".

La région, ainsi que la langue, peuvent également avoir une incidence sur la valeur renvoyée. Par exemple, le code de script pour "mn-MN" (Mongolien-Mongolie) est "Cyrl" (Cyrillique), alors que le code de script pour "mn-CN" (Mongolien-Chine) est "Mong" (Mongolien).

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Si le code de script ne fait pas partie du nom du paramètre régional spécifié, le code de script le plus ressemblant est « deviné », et la propriété lastOperationStatus définie sur LastOperationStatus.USING_FALLBACK_WARNING.

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

getVariant Renvoie le code de variante de langue spécifié par le nom de l’ID de paramètres régionaux.Code de variante de langue, ou chaîne vide si le nom de l’ID de paramètres régionaux ne contient pas de code de variante de langue. String Renvoie le code de variante de langue spécifié par le nom de l’ID de paramètres régionaux.

Cette méthode renvoie une chaîne vide en l’absence de code de variante de langue dans le nom de l’ID de paramètres régionaux. (Il n’est pas nécessaire de deviner le code, car les paramètres régionaux nécessitant une variante de langue sont peu nombreux.)

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

isRightToLeft Indique si le sens du texte correspondant aux paramètres régionaux spécifiés est de droite à gauche.true si les enchaînements de texte généraux au sein d’une ligne de texte vont de droite à gauche, false dans le cas contraire ; Boolean Indique si le sens du texte correspondant aux paramètres régionaux spécifiés est de droite à gauche.

Le résultat obtenu peut être utilisé pour déterminer le sens du texte dans le moteur de texte de Flash et pour décider si l’interface utilisateur doit être mise en miroir en vue de prendre en charge le sens du texte actuel.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

DEFAULT Indique que les préférences linguistiques par défaut doivent être utilisées, comme le spécifient les paramètres du système d’exploitation de l’utilisateur.i-defaultString Indique que les préférences linguistiques par défaut doivent être utilisées, comme le spécifient les paramètres du système d’exploitation de l’utilisateur. Par exemple, ces préférences sont généralement définies via le « Panneau de configuration » sous Windows ou les « Préférences système » sous Mac OS X.

L’utilisation du paramètre LocaleID.DEFAULT peut impliquer le recours à un autre nom d’ID de paramètres régionaux pour différents types d’opérations. Par exemple, il est possible d’utiliser des paramètres régionaux pour le classement et d’autres pour le formatage. Cette flexibilité respecte les préférences de l’utilisateur et la classe se comporte de cette façon par défaut.

Cet ID de paramètres régionaux n’est pas toujours le plus approprié. Pour les applications s’exécutant dans le navigateur, il est sans doute plus judicieux d’utiliser les paramètres régionaux favoris du navigateur. Par ailleurs, il est parfois préférable de laisser l’utilisateur modifier le nom de l’ID de paramètres régionaux favoris et de conserver cette préférence dans un profil utilisateur, un cookie ou un objet partagé.

lastOperationStatus Etat de la dernière opération que cet objet LocaleID a effectuée.String Etat de la dernière opération que cet objet LocaleID a effectuée. La propriété lastOperationStatus est définie chaque fois que le constructeur ou une méthode de cette classe est appelé(e), ou qu’une autre propriété est définie. Pour les valeurs disponibles, voir la description de chaque méthode. name Renvoie un identificateur de paramètres régionaux légèrement plus « canonique ».String Renvoie un identificateur de paramètres régionaux légèrement plus « canonique ».

Cette méthode effectue les conversions suivantes pour donner au nom de l’ID de paramètres régionaux une forme plus canonique.

La casse appropriée est appliquée à l’ensemble des composants.
Les traits de soulignement sont convertis en tirets.

Aucun traitement supplémentaire n’est effectué. Par exemple, les alias ne sont pas remplacés, et aucun élément n’est ajouté ou supprimé.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

DateTimeStyle Enumère les constantes qui déterminent un modèle de formatage de la date et de l’heure en fonction des paramètres régionaux.Object Enumère les constantes qui déterminent un modèle de formatage de la date et de l’heure en fonction des paramètres régionaux. Ces constantes sont utilisées lors de la construction d’un objet DateTimeFormatter ou de l’appel de la méthode DateTimeFormatter.setDateTimeStyles().

Il est impossible d’utiliser la constante CUSTOM dans le constructeur DateTimeFormatter ou la méthode DateFormatter.setDateTimeStyles(). Au lieu de cela, cette constante est définie en tant que propriétés timeStyle et dateStyle comme effet secondaire de l’appel de la méthode DateTimeFormatter.setDateTimePattern().

CUSTOM Indique qu’une chaîne modèle personnalisée est utilisée pour spécifier le style de date ou d’heure.customString Indique qu’une chaîne modèle personnalisée est utilisée pour spécifier le style de date ou d’heure. LONG Spécifie le style long pour une date ou une heure.longString Spécifie le style long pour une date ou une heure. MEDIUM Spécifie le style moyen pour une date ou une heure.mediumString Spécifie le style moyen pour une date ou une heure. NONE Indique que la date ou l’heure ne doit pas être incluse dans la chaîne formatée.noneString Indique que la date ou l’heure ne doit pas être incluse dans la chaîne formatée. SHORT Spécifie le style court pour une date ou une heure.shortString Spécifie le style court pour une date ou une heure. StringTools La classe StringTools fournit des méthodes de conversion de casse en fonction des paramètres régionaux.Object La classe StringTools fournit des méthodes de conversion de casse en fonction des paramètres régionaux.

Dans certaines situations, la conversion entre majuscules et minuscules ne consiste pas en une simple mise en correspondance de plusieurs caractères, mais requiert un traitement spécifique en fonction de la langue ou du contexte. Par exemple :

En turc et azéri, la majuscule de la lettre minuscule comportant un point i contient elle aussi un point İ (U+0130). De même, la lettre minuscule d’un majuscule sans point I est une minuscule sans point I (U+0131).
La lettre minuscule S, ß (U+00DF), utilisée en allemand, est convertie en majuscules doubles (SS).
En grec, il existe deux représentations du sigma minuscule, σ (U+03C3) et ς (U+03C2), tous deux convertis en sigma majuscule unique Σ (U+03A3).

Les méthodes toLowerCase() et toUpperCase() de cette classe fournissent cette logique de conversion de casse spéciale.

Cet exemple illustre la manière dont les différentes chaînes sont converties en minuscules et majuscules d’une façon linguistiquement correcte.

Cet exemple suit la procédure ci-dessous :

Crée un objet StringTools.
Définit trois chaînes avec des caractères uniques pour le turc, le grec, et l’allemand.
Convertit chaque chaîne en majuscules et minuscules, et affiche les résultats. Cet exemple illustre un comportement intéressant (propre aux paramètres régionaux) des caractères turcs "Ä±" et "Ä°", des caractères allemands "ÃŸ" et des caractères grecs "Î£Ï‚Ïƒ".

package { import flash.display.Sprite; import flash.globalization.LocaleID; import flash.globalization.StringTools; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class StringToolsExample extends Sprite { public function StringToolsExample() { var localeName:String= LocaleID.DEFAULT; var strTool:StringTools = new StringTools(localeName); trace('\n\n' + "LocaleID requested: " + nf.requestedLocaleIDName + "; actual: " + nf.actualLocaleIDName); trace( "Last Operation Status:" + nf.lastOperationStatus ); var turkishStr:String = "iI Ä±Ä°"; var greekStr:String = "Î£Ï‚ÏƒÎ²Î°Î�Î£"; var germanStr:String= "ÃŸ"; var tfTurInp:TextField = createTextField(10, 10); tfTurInp.text="Turkish Input: \t " + turkishStr; var tfdash:TextField = createTextField(10, 20); tfdash.text="-------------------"; var tf1:TextField = createTextField(10, 30); tf1.text="\t Upper case: \t " + strTool.toUpperCase(turkishStr); var tf2:TextField = createTextField(10, 40); tf2.text="\t Lower case: \t " + strTool.toLowerCase(turkishStr); var tfgreekInp:TextField = createTextField(10, 60); tfgreekInp.text="Greek Input: \t " + greekStr; var tfdash1:TextField = createTextField(10, 70); tfdash1.text="-------------------"; var tf3:TextField = createTextField(10, 80); tf3.text="\t Upper case: \t " + strTool.toUpperCase(greekStr); var tf4:TextField = createTextField(10, 90); tf4.text="\t Lower case: \t " + strTool.toLowerCase(greekStr); var tfgermanInp:TextField = createTextField(10, 110); tfgermanInp.text="German Input: \t " + germanStr; var tfdash2:TextField = createTextField(10, 120); tfdash2.text="-------------------"; var tf5:TextField = createTextField(10, 130); tf5.text="\t Upper case: \t " + strTool.toUpperCase(germanStr); var tf6:TextField = createTextField(10, 140); tf6.text="\t Lower case: \t " + strTool.toLowerCase(germanStr); } private function createTextField(x:Number, y:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.autoSize=TextFieldAutoSize.LEFT; addChild(result); return result; } } } StringTools Construit un nouvel objet StringTools qui fournit une conversion de casse et d’autres utilitaires selon les conventions d’un jeu de paramètres régionaux donné.si le paramètre requestedLocaleIDName est null ArgumentErrorArgumentErrorrequestedLocaleIDNameStringNom de l’identificateur de paramètres régionaux à utiliser lors de la spécification des formats de date ou d’heure. Construit un nouvel objet StringTools qui fournit une conversion de casse et d’autres utilitaires selon les conventions d’un jeu de paramètres régionaux donné.

Ce constructeur détermine si le système d’exploitation actuel prend en charge le nom de l’identificateur de paramètres régionaux requis. Si ce n’est pas le cas, des paramètres régionaux de substitution sont utilisés. Si des paramètres régionaux de substitution sont utilisés, la propriété lastOperationStatus indique le type de paramètres de substitution, et la propriété actualLocaleIDName contient le nom de ces paramètres.

Lorsque ce constructeur se termine avec succès, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Lorsque le nom de l’identificateur de paramètres régionaux requis n’est pas disponible, la propriété lastOperationStatus est définie sur l’une des valeurs suivantes :

LastOperationStatus.USING_FALLBACK_WARNING
LastOperationStatus.USING_DEFAULT_WARNING

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Si cette classe n’est pas prise en charge sur le système d’exploitation actuel, cette méthode renvoie une valeur nulle.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

toLowerCase Convertit une chaîne en majuscules selon les conventions de langue.si le paramètre s est null ArgumentErrorArgumentErrorLa chaîne convertie en minuscules. StringsStringChaîne à convertir en minuscules. Convertit une chaîne en majuscules selon les conventions de langue. Selon le jeu de paramètres régionaux, il est possible que la longueur de la chaîne de sortie soit différente de celle de la chaîne d’entrée.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

toUpperCase Convertit une chaîne en majuscules selon les conventions de langue.si le paramètre s est null ArgumentErrorArgumentErrorLa chaîne convertie en majuscules. StringsStringChaîne à convertir en majuscules. Convertit une chaîne en majuscules selon les conventions de langue. Selon le jeu de paramètres régionaux, il est possible que la longueur de la chaîne de sortie soit différente de celle de la chaîne d’entrée.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

actualLocaleIDName Nom de l’identificateur de paramètres régionaux actuel utilisé par cet objet StringTools.String Nom de l’identificateur de paramètres régionaux actuel utilisé par cet objet StringTools.

Il existe trois possibilités pour la valeur du nom, en fonction du système d’exploitation et de la valeur du paramètre requestedLocaleIDName transmis au constructeur StringTools().

Si les paramètre régionaux requis n’étaient pas définis sur LocaleID.DEFAULT et que le système d’exploitation les prend en charge, le nom renvoyé est identique à la propriété requestedLocaleIDName.
Si LocaleID.DEFAULT a été utilisée comme valeur pour le paramètre requestedLocaleIDName transmis au constructeur, le nom des paramètres régionaux spécifié par le système d’exploitation de l’utilisateur est utilisé. La valeur LocaleID.DEFAULT préserve le paramètre personnalisé de l’utilisateur dans le système d’exploitation. La transmission d’une valeur explicite en tant que paramètre requestedLocaleIDName ne produit pas nécessairement le même résultat que l’utilisation de LocaleID.DEFAULT, même si le nom des deux identificateurs de paramètres régionaux est identique. Il est possible que l’utilisateur ait personnalisé les paramètres régionaux sur son ordinateur ; or, si vous demandez un identificateur de paramètres régionaux explicite au lieu d’utiliser LocaleID.DEFAULT, votre application ne récupérera pas ces paramètres personnalisés.

Par exemple :
var tools:StringTools = new StringTools(LocaleID.DEFAULT); var aliName:String = tools.actualLocaleIDName;
Dans l’exemple ci-dessus, aliName représente le nom des paramètres régionaux correspondant aux paramètres définis par l’utilisateur dans le système d’exploitation actuel (par exemple, "it-IT" si les paramètres régionaux de l’utilisateur sont définis sur Italien (Italie)) et non "i-default" (nom du paramètre LocaleID.DEFAULT).
Si le système ne prend pas en charge le paramètre requestedLocaleIDName spécifié dans le constructeur, un nom d’ID de paramètres régionaux par défaut est fourni.

Par exemple :
var tools:StringTools = new StringTools("fr-CA"); var aliName:String = tools.actualLocaleIDName;
Si le système d’exploitation dans l’exemple ci-dessus ne prend pas en charge l’ID de paramètres régionaux "fr_CA", c’est-à-dire Français (Canada), des paramètres de substitution sont fournis. Dans ce cas, l’ID de paramètres régionaux par défaut est "fr-FR", c’est-à-dire Français (France).

lastOperationStatus Etat de la dernière opération que cet objet StringTools a effectuée.String Etat de la dernière opération que cet objet StringTools a effectuée. La propriété lastOperationStatus est définie chaque fois que le constructeur ou une méthode de cette classe est appelé(e), ou qu’une autre propriété est définie. Pour les valeurs disponibles, voir la description de chaque méthode. requestedLocaleIDName Nom de l’identificateur de paramètres régionaux requis ayant été transmis au constructeur de cet objet StringTools.String Nom de l’identificateur de paramètres régionaux requis ayant été transmis au constructeur de cet objet StringTools.

CollatorMode La classe CollatorMode énumère les valeurs constantes qui gèrent le comportement des comparaisons de chaînes effectuées par un objet Collator.Object La classe CollatorMode énumère les valeurs constantes qui gèrent le comportement des comparaisons de chaînes effectuées par un objet Collator. Ces constantes représentent les valeurs pouvant être transmises dans le paramètre initialMode du constructeur Collator(),. MATCHING Initialise un objet Collator pour optimiser la méthode de comparaison en vue de déterminer si deux chaînes sont équivalentes.matchingString Initialise un objet Collator pour optimiser la méthode de comparaison en vue de déterminer si deux chaînes sont équivalentes. Dans ce mode, les comparaisons de chaînes ne tiennent pas compte des différences entre majuscules et minuscules, des caractères accentués, etc. SORTING Initialise un objet Collator pour optimiser la méthode de comparaison en vue de trier une liste de chaînes de texte devant être présentées à l’utilisateur final.sortingString Initialise un objet Collator pour optimiser la méthode de comparaison en vue de trier une liste de chaînes de texte devant être présentées à l’utilisateur final. Dans ce mode, les comparaisons de chaînes prennent en compte les différences entre majuscules et minuscules, les caractères accentués, etc., en fonction de la langue et des règles de tri requises par les paramètres régionaux. NumberFormatter La classe NumberFormatter permet le formatage et l’analyse des valeurs numériques en fonction des paramètres régionaux.Object La classe NumberFormatter permet le formatage et l’analyse des valeurs numériques en fonction des paramètres régionaux. Elle permet de formater les objets int, uint et Number.

La classe NumberFormatter utilise les données et les fonctionnalités fournies par le système d’exploitation, et est conçue pour formater les nombres conformément aux conventions de paramètres régionaux spécifiques, en fonction des préférences de l’utilisateur et des fonctionnalités prises en charge par le système d’exploitation de l’utilisateur. La position du symbole négatif, le séparateur décimal, le séparateur de groupement, le modèle de groupement et d’autres éléments au sein du format numérique peuvent varier selon les paramètres régionaux.

Si le système d’exploitation prend en charge les paramètres régionaux requis, les propriétés de formatage des nombres sont définies en fonction des conventions et des valeurs par défaut des paramètres régionaux requis. Si les paramètres régionaux requis ne sont pas disponibles, les propriétés sont définies en fonction de paramètres régionaux par défaut, pouvant être obtenus à l’aide de la propriété actualLocaleIDName.

Cet exemple illustre la façon dont les nombres peuvent être formatés différemment selon les paramètres régionaux.

Cet exemple utilise les paramètres régionaux suivants : paramètres régionaux par défaut du système d’exploitation pour le formatage des numéros, Japonais (Japon), Anglais (Etats-Unis) et Français (France). Cet exemple utilise le membre statique LocaleID.DEFAULT pour solliciter le jeu de paramètres régionaux par défaut du système d’exploitation.

Notez que les résultats de cet exemple peuvent varier en fonction du système d’exploitation et des préférences de l’utilisateur.

Cet exemple suit la procédure suivante pour chaque jeu de paramètres régionaux dans la liste :

Crée un objet NumberFormatter.
Formate la même valeur qu’un nombre, un entier et un entier non signé, et affiche les résultats.

package { import flash.globalization.NumberFormatter; import flash.globalization.LocaleID; public class NumberFormatterExample extends Sprite { public function NumberFormatterExample():void { var localeNames:Array = [LocaleID.DEFAULT,"ja_JP","en_US","fr_FR"]; for ( var i:int = 0; i < localeNames.length; i++ ) { var nf:NumberFormatter = new NumberFormatter( localeNames[i] as String ); trace('\n\n' + "LocaleID requested: " + nf.requestedLocaleIDName + "; actual: " + nf.actualLocaleIDName); trace( "Last Operation Status:" + nf.lastOperationStatus ); var numberString:String = nf.formatNumber(123456789.19); trace( "Formatted Number:" + numberString); numberString = nf.formatInt(-123456789); trace( "Formatted Int:" + numberString); numberString = nf.formatUint(123456789); trace( "Formatted UInt:" + numberString); } } } } Cet exemple illustre deux manières différentes pour analyser une chaîne d’entrée et extraire une valeur numérique.

Notez que les résultats de cet exemple peuvent varier en fonction du système d’exploitation et des préférences de l’utilisateur.

Cet exemple effectue les opérations suivantes :

Crée un objet NumberFormatter.
Appelle la méthode NumberFormatter.parse() pour analyser la chaîne et renvoie un objet NumberParseResult.
Appelle la méthode NumberFormatter.parseNumber() pour analyser la chaîne et renvoie une valeur numérique.

package { import flash.globalization.NumberFormatter; import flash.globalization.NumberParseResult; import flash.globalization.LastOperationStatus; import flash.globalization.LocaleID; public class NumberFormatterParseExample { public function NumberFormatterParseExample():void { var nf:NumberFormatter = new NumberFormatter( "en_US" ); trace("LocaleID requested: " + nf.requestedLocaleIDName + "; actual: " + nf.actualLocaleIDName); trace( "Last Operation Status:" + nf.lastOperationStatus ); var inputNumberString:String = "123,567,89,0.254"; var parseResult:NumberParseResult = nf.parse(inputNumberString); if ( nf.lastOperationStatus == LastOperationStatus.NO_ERROR ) { trace("Parsed value:" + parseResult.value); } inputNumberString = "-123,567,89,0.254"; var parsedNumber:Number = nf.parseNumber(inputNumberString); if ( nf.lastOperationStatus == LastOperationStatus.NO_ERROR ) { trace("Parsed value:" + parsedNumber); } } } } NumberFormatter Construit un nouvel objet NumberFormatter pour formater les numéros en fonction des conventions de paramètres régionaux donnés.si requestedLocaleIDName est null TypeErrorTypeErrorrequestedLocaleIDNameStringNom de l’identificateur de paramètres régionaux à utiliser lors de la spécification des nombres. Construit un nouvel objet NumberFormatter pour formater les numéros en fonction des conventions de paramètres régionaux donnés.

Ce constructeur détermine si le système d’exploitation actuel prend en charge le nom de l’identificateur de paramètres régionaux requis. Si ce n’est pas le cas, des paramètres régionaux de substitution sont utilisés. En cas d’utilisation de paramètres régionaux de substitution, la propriété lastOperationStatus indique le type de paramètres de substitution, et la propriété actualLocaleIDName contient le nom de ces paramètres.

Lorsque le constructeur se termine avec succès, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Lorsque le nom de l’identificateur de paramètres régionaux requis n’est pas disponible, la propriété lastOperationStatus est définie sur l’une des valeurs suivantes :

LastOperationStatus.USING_FALLBACK_WARNING
LastOperationStatus.USING_DEFAULT_WARNING

Si cette classe n’est pas prise en charge sur le système d’exploitation, la propriété lastOperationStatus est définie sur :

LastOperationStatus.UNSUPPORTED_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Pour plus d’informations sur les avertissements répertoriés ci-dessus et d’autres valeurs possibles de la propriété lastOperationStatus, voir les descriptions de la classe LastOperationStatus.

formatInt Formate une valeur int.pour tout problème d’allocation de mémoire interne. MemoryErrorflash.errors:MemoryErrorChaîne numérique formatée. StringvalueintValeur int à formater. Formate une valeur int. Cette fonction équivaut à la méthode formatNumber(), sauf qu’elle prend une valeur int. Si la valeur transmise est trop grande ou trop petite, c’est le cas notamment d’une valeur supérieure à 1.72e308 ou inférieure à 1.72e-308, cette fonction renvoie la valeur 0.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

formatNumber Formate une valeur Number.en cas de problèmes d’allocation de mémoire interne. MemoryErrorflash.errors:MemoryErrorChaîne numérique formatée. StringvalueNumberValeur numérique à formater. Formate une valeur Number.

Cette fonction formate le nombre en fonction des valeurs de propriété de l’outil de formatage. Si les propriétés ne sont pas modifiées après la création de l’objet numberFormatter, les nombres sont formatés en fonction des paramètres régionaux en vigueur fournis par le système d’exploitation correspondant aux paramètres régionaux identifiés par actualLocaleIDName. Pour personnaliser le format, les propriétés peuvent être modifiées en vue de contrôler certains aspects de formatage d’un nombre.

Les très grands nombres et les nombres à très petite amplitude peuvent être formatés avec cette fonction. Cependant, le nombre de chiffres est limité à la précision fournie par l’objet Number. La notation scientifique n’est pas pris en charge.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

formatUint Formate une valeur uint.en cas de problèmes d’allocation de mémoire interne. MemoryErrorflash.errors:MemoryErrorChaîne numérique formatée. StringvalueuintUne valeur uint. Formate une valeur uint. Cette fonction équivaut à la méthode formatNumber(), sauf qu’elle prend une valeur uint. Si la valeur transmise est trop volumineuse, notamment si une valeur est supérieure à 1.72e308, cette fonction renvoie la valeur 0.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Si cette classe n’est pas prise en charge sur le système d’exploitation actuel, cette méthode renvoie une valeur nulle.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

parseNumber Analyse une chaîne qui contient uniquement des chiffres et des espaces blancs facultatifs, et renvoie un nombre.si parseString est null TypeErrorTypeErrorNumberparseStringString Analyse une chaîne qui contient uniquement des chiffres et des espaces facultatifs, et renvoie un nombre. Si la chaîne ne commence pas par un nombre ou contient des caractères autres que des espaces qui ne font pas partie du nombre, cette méthode renvoie NaN. Une espace blanc avant ou après les chiffres numériques est ignoré. Un espace blanc est un caractère disposant d’une propriété de séparateur d’espace (Zs) dans la base de données des caractères Unicode (voir http://www.unicode.org/ucd/).

Si le chiffre est précédé ou suivi d’un signe plus « + », il est considéré comme un caractère autre qu’un espace blanc. La valeur renvoyée est NaN.

Voir la description de la fonction d’analyse pour plus d’informations sur l’analyse des nombres et les caractéristiques d’un numéro valide.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

parse Analyse une chaîne et renvoie un objet NumberParseResult contenant les éléments analysés.si parseString est null TypeErrorTypeErrorflash.globalization:NumberParseResultparseStringString Analyse une chaîne et renvoie un objet NumberParseResult contenant les éléments analysés.

L’objet NumberParseResult contient la valeur du premier nombre détecté dans la chaîne saisie, l’index de début correspondant au nombre dans la chaîne, et l’index du premier caractère après le nombre de la chaîne.

Si la chaîne ne contient pas de nombre, la propriété value de l’objet NumberParseResult est définie sur NaN, et les propriétés startIndex et endIndex sont définies sur la valeur hexadécimale 0x7fffffff.

Cette fonction utilise la valeur de la propriété decimalSeparator pour déterminer la partie du nombre contenant les chiffres fractionnaires, la propriété groupingSeparator pour identifier les caractères autorisés dans les chiffres d’un nombre, ainsi que la propriété negativeNumberFormat pour gérer le mode de représentation des valeurs négatives.

Le tableau suivant identifie le résultat des chaînes analysées pour les différentes valeurs de la propriété NegativeNumberFormat :

NegativeNumberFormatChaîne d’entréeRésultat(n)"(123)" ou "( 123 )""-123"-n"-123" ou "- 123""-123"- n"-123" ou "- 123""-123"n-"123-" ou "123 -""-123"n -"123-" ou "123 -""-123"

Un seul espace blanc est autorisé entre le numéro et le signe moins ou la parenthèse.

D’autres propriétés sont ignorées pour déterminer si un nombre est valide. Concrètement, la valeur de la propriété digitsType est ignorée et les chiffres peuvent provenir de l’un des jeux de chiffres énumérés dans la classe NationalDigitsType. Les valeurs des propriétés groupingPattern et useGrouping n’ont aucune incidence sur l’analyse du nombre.

Dans la chaîne, si les nombres sont précédés ou suivis d’un signe plus (+), ce signe est traité comme un caractère ne faisant pas partie du nombre.

Cette fonction n’analyse pas les chaînes contenant des nombres en notation scientifique (par exemple, 1.23e40).

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Le code suivant analyse un nombre à partir d’une chaîne, et extrait le préfixe et le suffixe : var nf:NumberFormatter = new NumberFormatter("fr-FR"); var str:String = "1,56 mètre" var result:NumberParseResult = nf.parse(str); trace(result.value) // 1.56 trace(str.substr(0,result.startIndex)); // "" trace(str.substr(result.startIndex, result.endIndex)); // "1,56" trace(str.substr(result.endIndex)); // " mètre" actualLocaleIDName Nom de l’identificateur de paramètres régionaux actuel utilisé par cet objet NumberFormatter.String Nom de l’identificateur de paramètres régionaux actuel utilisé par cet objet NumberFormatter.

Il existe trois possibilités pour la valeur du nom, en fonction du système d’exploitation et de la valeur du paramètre requestedLocaleIDName transmis au constructeur Collator().

Si les paramètre régionaux requis n’étaient pas définis sur LocaleID.DEFAULT et que le système d’exploitation les prend en charge, le nom renvoyé est identique à la propriété requestedLocaleIDName.
Si LocaleID.DEFAULT a été utilisée comme valeur pour le paramètre requestedLocaleIDName transmis au constructeur, le nom des paramètres régionaux spécifié par le système d’exploitation de l’utilisateur est utilisé. La valeur LocaleID.DEFAULT préserve le paramètre personnalisé de l’utilisateur dans le système d’exploitation. La transmission d’une valeur explicite en tant que paramètre requestedLocaleIDName ne produit pas nécessairement le même résultat que l’utilisation de LocaleID.DEFAULT, même si le nom des deux identificateurs de paramètres régionaux est identique. Il est possible que l’utilisateur ait personnalisé les paramètres régionaux sur son ordinateur ; or, si vous demandez un identificateur de paramètres régionaux explicite au lieu d’utiliser LocaleID.DEFAULT, votre application ne récupérera pas ces paramètres personnalisés.

Par exemple :
var fmt:NumberFormatter = new NumberFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName;
Dans l’exemple ci-dessus, aliName représente le nom des paramètres régionaux correspondant aux paramètres définis par l’utilisateur dans le système d’exploitation actuel (par exemple, "it-IT" si les paramètres régionaux de l’utilisateur sont définis sur Italien (Italie)) et non "i-default" (nom du paramètre LocaleID.DEFAULT).
Si le système ne prend pas en charge le paramètre requestedLocaleIDName spécifié dans le constructeur, un nom d’ID de paramètres régionaux par défaut est fourni.

Par exemple :
var fmt:NumberFormatter = new NumberFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName;
Si le système d’exploitation dans l’exemple ci-dessus ne prend pas en charge l’ID de paramètres régionaux "fr_CA", c’est-à-dire Français (Canada), des paramètres de substitution sont fournis. Dans ce cas, l’ID de paramètres régionaux par défaut est "fr-FR", c’est-à-dire Français (France).

decimalSeparator Le séparateur décimal utilisé pour le formatage ou l’analyse des nombres ayant une partie décimale.Stringsi cette propriété se voit attribuer une valeur null. TypeErrorTypeErrordependent on the locale and operating system. Le séparateur décimal utilisé pour le formatage ou l’analyse des nombres ayant une partie décimale.

Cette propriété est initialement définie en fonction des paramètres régionaux sélectionnés lors de la construction de l’objet formatter.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

digitsType Définit le jeu de caractères numériques à utiliser lors du formatage des nombres.uintsi cette propriété se voit attribuer une valeur null. TypeErrorTypeErrordependent on the locale and operating system. Définit le jeu de caractères numériques à utiliser lors du formatage des nombres.

Selon les langues et les régions, différents jeux de caractères sont utilisés pour représenter les chiffres de 0 à 9. Cette propriété définit le jeu de chiffres à utiliser.

La valeur de cette propriété représente la valeur Unicode pour le chiffre zéro d’un jeu de chiffres décimaux. Les valeurs valides de cette propriété sont définies dans la classe NationalDigitsType.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

fractionalDigits Nombre maximal de chiffres pouvant apparaître après le séparateur décimal.int0 Nombre maximal de chiffres pouvant apparaître après le séparateur décimal.

Les numéros sont arrondis au nombre de chiffres spécifié par cette propriété. Le modèle d’arrondi varie selon le système d’exploitation de l’utilisateur.

Lorsque la propriété trailingZeros est définie sur true, la partie fractionnaire du nombre (après le point décimal) est suivie de zéros (à droite) jusqu’à ce que sa longueur corresponde à la valeur de cette propriété fractionalDigits.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

groupingPattern Décrit le placement des séparateurs de groupes dans la chaîne de nombres formatée.Stringsi cette propriété se voit attribuer une valeur null. TypeErrorTypeError Décrit le placement des séparateurs de groupes dans la chaîne de nombres formatée.

Lorsque la propriété useGrouping est définie sur true, la propriété groupingPattern permet de définir le placement et le modèle utilisé pour le séparateur de groupes.

Le modèle de groupement est défini en tant que chaîne contenant des numéros séparés par des points-virgules et pouvant se terminer par un astérisque. Par exemple : "3;2;*". Chaque numéro dans la chaîne représente le nombre de chiffres dans un groupe. Le séparateur de groupes est placé avant chaque groupe de chiffres. Un astérisque à la fin de la chaîne indique que les groupes avec ce nombre de chiffres doivent être répétés pour le reste de la chaîne formatée. S’il n’y a pas d’astérisque, il n’y a aucun groupe ou séparateur supplémentaire pour le reste de la chaîne formatée.

Le premier nombre dans la chaîne correspond au premier groupe de chiffres à gauche du séparateur décimal. Les nombres suivants définissent le nombre de chiffres dans les groupes suivants se trouvant à gauche. Ainsi, la chaîne "3;2;*" indique qu’un séparateur de groupes est placé après le premier groupe de 3 chiffres, suivi par des groupes de 2 chiffres. Par exemple : 98,76,54,321

Le tableau ci-dessous présente des exemples de formatage du nombre 123456789.12 avec divers modèles de groupement. Le séparateur de groupes est une virgule et le séparateur décimal est un point.

Modèle de groupementExemple de format3;*123,456,789.123;2;*12,34,56,789.123123456,789.12

Seul un nombre limité de tailles de groupement peut être défini. Sur certains systèmes d’exploitation, les modèles de groupement ne peuvent contenir que deux nombres et un astérisque. D’autres systèmes d’exploitation peuvent prendre en charge jusqu’à quatre nombres et un astérisque. Pour les modèles sans astérisque, certains systèmes d’exploitation ne prennent en charge qu’un seul nombre, alors que d’autres prennent en charge jusqu’à trois nombres. Si le nombre maximum d’éléments de modèles de groupement est dépassé, d’autres éléments sont ignorés et la propriété lastOperationStatus est définie comme indiqué ci-dessous.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

groupingSeparator Caractère ou chaîne utilisé(e) pour le séparateur de groupes.Stringsi cette propriété se voit attribuer une valeur null. TypeErrorTypeErrordependent on the locale and operating system. Caractère ou chaîne utilisé(e) pour le séparateur de groupes.

La valeur de cette propriété est utilisée comme séparateur de groupes lors du formatage des nombres lorsque la propriété useGrouping est définie sur true. Cette propriété est initialement définie en fonction des paramètres régionaux sélectionnés lors de la construction de l’objet formatter.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

lastOperationStatus Etat de dernière opération que cet objet NumberFormatter a effectuée.String Etat de dernière opération que cet objet NumberFormatter a effectuée. La propriété lastOperationStatus est définie chaque fois que le constructeur ou une méthode de cette classe est appelé(e), ou qu’une autre propriété est définie. Pour les valeurs disponibles, voir la description de chaque méthode. leadingZero Indique si un nombre est précédé d’un zéro lorsque celui-ci ne contient aucun nombre entier à gauche du séparateur décimal.Booleansi cette propriété se voit attribuer une valeur null. TypeErrorTypeErrordependent on the locale and operating system. Indique si un nombre est précédé d’un zéro lorsque celui-ci ne contient aucun nombre entier à gauche du séparateur décimal.

Lorsque cette propriété est définie sur true, un zéro est inséré à gauche du séparateur décimal lors du formatage des valeurs numériques comprises entre -1.0 et 1.0. Lorsque cette propriété est définie sur false, aucun zéro n’est inséré.

Par exemple si le nombre est 0.321 et que cette propriété est définie sur true, le zéro est inclus dans la chaîne formatée. Si la propriété est définie sur false, le zéro n’est inclus. Dans ce cas, la chaîne inclut uniquement le séparateur décimal, suivi des chiffres décimaux, comme .321.

Le tableau ci-dessous présente des exemples sur la façon dont les nombres sont formatés en fonction des valeurs de cette propriété, ainsi que des propriétés fractionalDigits et trailingZeros associées.

trailingZerosleadingZerofractionalDigits0.120truetrue30.1200.000falsetrue30.120truefalse3.120.000falsefalse3.120

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

negativeNumberFormat Valeur numérique qui indique un modèle de formatage pour les nombres négatifs.uintsi la valeur assignée n’est pas un numéro compris entre 0 et 4. ArgumentErrorArgumentErrordependent on the locale and operating system. Valeur numérique qui indique un modèle de formatage pour les nombres négatifs. Ce modèle définit l’emplacement du symbole négatif ou des parenthèses par rapport à la partie numérique du nombre formaté.

Le tableau suivant récapitule les formats disponibles pour les nombres négatifs. Lorsqu’un nombre négatif est formaté, le signe moins est remplacé par la valeur de la propriété negativeSymbol et le caractère « n » par la valeur numérique formatée.

Type de format de nombre négatifFormat0(n)1-n2- n3n-4n -

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

negativeSymbol Symbole négatif à utiliser lors du formatage des valeurs négatives.Stringsi le système ne parvient pas à allouer suffisamment de mémoire interne. MemoryErrorflash.errors:MemoryError Symbole négatif à utiliser lors du formatage des valeurs négatives.

Ce symbole est utilisé avec le format de nombre négatif lors du formatage d’un nombre inférieur à zéro. Il n’est pas utilisé dans des formats de nombre négatif qui n’incluent pas de signe négatif (notamment lorsque des nombres négatifs se trouvent entre parenthèses).

Cette propriété est définie sur une valeur par défaut pour les paramètres régionaux sélectionnés lors de la construction de cette classe de formatage. Elle peut être définie sur une valeur de façon à remplacer le paramètre par défaut.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

requestedLocaleIDName Nom de l’identificateur de paramètres régionaux requis ayant été transmis au constructeur de cet objet NumberFormatter.String Nom de l’identificateur de paramètres régionaux requis ayant été transmis au constructeur de cet objet NumberFormatter.

trailingZeros Indique si un nombre formaté est précédé de zéros.Booleansi cette propriété se voit attribuer une valeur null. TypeErrorTypeErrordependent on the locale and operating system. Indique si un nombre formaté est précédé de zéros.

Lorsque cette propriété est définie sur true, des zéros sont insérés à droite de la partie fractionnaire du nombre formaté, en respectant la limite spécifiée par la propriété fractionalDigits. Lorsque cette propriété est définie sur false, aucun zéro n’est inséré.

Par exemple, si la valeur numérique est 123.4, si cette propriété est définie sur true et si la propriété fractionalDigits est définie sur 3, la chaîne formatée affiche les zéros, comme suit : 123.400. Si cette propriété est définie sur false, aucun zéro n’est inclus et la chaîne affiche uniquement le séparateur décimal, suivi des chiffres décimaux (autres que zéro), comme suit : 123.4.

Le tableau ci-dessous présente des exemples sur la façon dont les valeurs numériques sont formatées en fonction des valeurs de cette propriété, ainsi que des propriétés fractionalDigits et trailingZeros associées.

trailingZerosleadingZerofractionalDigits0.120truetrue30.1200.000falsetrue30.120truefalse3.120.000falsefalse3.120

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

useGrouping Permet l’utilisation du séparateur de groupes lors du formatage des nombres.Boolean Permet l’utilisation du séparateur de groupes lors du formatage des nombres.

Lorsque la propriété useGrouping est définie sur true, les chiffres sont groupés et délimités par le caractère de séparation de groupes. Par exemple : 123,456,789.22

Lorsque la propriété useGrouping est définie sur false, les chiffres ne sont ni groupés ni séparés. Par exemple : 123456789.22

Le symbole à utiliser en tant que séparateur de groupes est défini par la propriété groupingSeparator. Le nombre de chiffres compris entre les séparateurs de groupes est défini par la propriété groupingPattern.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

DateTimeNameContext La classe DateTimeNameContext énumère les valeurs constantes qui représentent le contexte de formatage dans lequel est utilisé le nom d’un mois ou d’un jour de la semaine.Object La classe DateTimeNameContext énumère les valeurs constantes qui représentent le contexte de formatage dans lequel est utilisé le nom d’un mois ou d’un jour de la semaine. Ces constantes sont utilisées pour le paramètre context des méthodes getMonthNames() et getWeekDayNames() de DateTimeFormatter.

Le paramètre context modifie le résultat uniquement pour les méthodes de certains paramètres régionaux et systèmes d’exploitation. Pour la plupart des paramètres régionaux, les listes des noms des mois et des jours de la semaine ne sont pas affectées par le paramètre context.

FORMAT Indique que le nom de l’élément date est utilisé dans un format de date.formatString Indique que le nom de l’élément date est utilisé dans un format de date. STANDALONE Indique que le nom de l’élément date est utilisé dans un contexte « autonome », indépendamment des autres formats.standaloneString Indique que le nom de l’élément date est utilisé dans un contexte « autonome », indépendamment des autres formats. Par exemple, le nom peut être utilisé pour afficher uniquement le nom d’un mois dans un calendrier, ou le nom d’un jour de la semaine dans un sélecteur de dates. DateTimeNameStyle La classe DateTimeNameStyle énumère les constantes qui gèrent la longueur des noms de mois et de jours de la semaine utilisée lors du formatage des dates.Object La classe DateTimeNameStyle énumère les constantes qui gèrent la longueur des noms de mois et de jours de la semaine utilisée lors du formatage des dates. Utilisez ces constantes pour le paramètre nameStyle des méthodes getMonthNames() et getWeekDayNames() de DateTimeFormatter.

Les valeurs LONG_ABBREVIATION et SHORT_ABBREVIATION peuvent être identiques ou différentes selon les paramètres du système d’exploitation.

FULL Spécifie le style de forme complète ou de nom complet pour le nom des mois et des jours de la semaine.fullString Spécifie le style de forme complète ou de nom complet pour le nom des mois et des jours de la semaine. Exemples : mardi, novembre. LONG_ABBREVIATION Spécifie le style d’abréviation longue pour le nom des mois et des jours de la semaine.longAbbreviationString Spécifie le style d’abréviation longue pour le nom des mois et des jours de la semaine. Exemples : mar pour mardi, nov pour novembre. SHORT_ABBREVIATION Spécifie le style d’abréviation courte pour le nom des mois et des jours de la semaine.shortAbbreviationString Spécifie le style d’abréviation courte pour le nom des mois et des jours de la semaine. Exemples : M pour mardi, N pour novembre. CurrencyFormatter La classe CurrencyFormatter permet le formatage et l’analyse des valeurs monétaires en fonction des paramètres régionaux.Object La classe CurrencyFormatter permet le formatage et l’analyse des valeurs monétaires en fonction des paramètres régionaux.

La classe CurrencyFormatter utilise les données et les fonctionnalités fournies par le système d’exploitation, et est conçue pour formater les valeurs monétaires conformément aux conventions de paramètres régionaux spécifiques et au type de devise. La position du symbole de devise, le symbole négatif, le séparateur décimal, le séparateur de groupes, le séparateur décimal du modèle de groupement, ainsi que d’autres éléments peuvent varier selon les paramètres régionaux.

Si le système d’exploitation prend en charge les paramètres régionaux requis, les propriétés et le type de devise sont définis en fonction des conventions et des valeurs par défaut des paramètres régionaux requis. Si les paramètres régionaux requis ne sont pas disponibles, les propriétés sont définies en fonction de paramètres régionaux par défaut, pouvant être obtenus à l’aide de la propriété actualLocaleIDName.

L’exemple suivant indique comment un montant en devise est formaté en fonction des différents paramètres régionaux et devises. Notez que les résultats de cet exemple peuvent varier en fonction du système d’exploitation et des préférences de l’utilisateur.

Cet exemple utilise les paramètres régionaux suivants :

Jeu de paramètres régionaux par défaut du système d’exploitation pour le formatage des devises (LocaleID.DEFAULT)
Japonais (Japon)
Anglais (Etats-Unis)
Français (France)

Cet exemple effectue les opérations suivantes pour chaque jeu de paramètres régionaux dans la liste :

Crée un objet CurrencyFormatter.
Utilise la méthode formattingWithCurrencySymbolIsSafe() pour vérifier si la devise par défaut correspondant au jeu de paramètres régionaux est euros (« EUR ») et, si tel est le cas, formate la chaîne en utilisant le symbole de devise. Dans le cas contraire, la chaîne est formatée à l’aide du code 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); } } } } } L’exemple suivant analyse un montant en devise à l’aide des règles d’un jeu de paramètres régionaux donné. Notez que les résultats de cet exemple peuvent varier en fonction du système d’exploitation et des préférences de l’utilisateur.

Cet exemple suit la procédure ci-dessous :

Crée un objet CurrencyFormatter pour le jeu de paramètres régionaux Anglais (Etats-Unis).
Utilise la méthode parse() pour analyser la chaîne d’entrée.
Affiche les valeurs des chaînes de montant et devise de l’objet CurrencyParseResult résultant.

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); } } } } CurrencyFormatter Construit un nouvel objet CurrencyFormatter pour formater les nombres représentant des montants en devise en fonction des conventions des paramètres régionaux en vigueur.si le paramètre requestedLocaleIDName est null. TypeErrorTypeErrorrequestedLocaleIDNameStringNom de l’identificateur de paramètres régionaux à utiliser lors de la spécification des formats de date ou d’heure. Construit un nouvel objet CurrencyFormatter pour formater les nombres représentant des montants en devise en fonction des conventions des paramètres régionaux en vigueur.

Ce constructeur détermine si le système d’exploitation actuel prend en charge le nom de l’identificateur de paramètres régionaux requis. Si ce n’est pas le cas, des paramètres régionaux de substitution sont utilisés. Si des paramètres régionaux de substitution sont utilisés, la propriété lastOperationStatus indique le type de paramètres de substitution, et la propriété actualLocaleIDName contient le nom de ces paramètres.

Certaines propriétés, telles que currencySymbol et currencyISOCode, sont automatiquement définies en fonction des paramètres régionaux.

REMARQUE : en cas d’utilisation d’un jeu de paramètres régionaux de substitution, les propriétés de devise sont définies sur des valeurs par défaut. Par conséquent, il est possible que la propriété currencySymbol ou currencyISOCode se voit attribuer des valeurs inattendues. Il est conseillé d’examiner les valeurs des propriétés currencySymbol et currencyISOCode avant de formater un montant en devise.

Lorsque le constructeur est appelé et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Lorsque le nom de l’identificateur de paramètres régionaux requis n’est pas disponible, la propriété lastOperationStatus est définie sur l’une des valeurs suivantes :

LastOperationStatus.USING_FALLBACK_WARNING
LastOperationStatus.USING_DEFAULT_WARNING

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

format Crée une chaîne représentant un montant en devise formaté selon les propriétés actuelles de cet objet CurrencyFormatter, à savoir le jeu de paramètres régionaux, le symbole de devise et le code ISO de la devise.Chaîne contenant la valeur monétaire formatée. StringvalueNumberValeur numérique devant être formatée dans une chaîne de devise. withCurrencySymbolBooleanfalseLorsqu’elle est définie sur false, la propriété currencyISOCode détermine la chaîne de devise ou le symbole de devise à utiliser dans la chaîne de sortie. Lorsqu’elle est définie sur true, la valeur actuelle de la propriété currencySymbol est utilisée dans la chaîne de sortie. Crée une chaîne représentant un montant en devise formaté selon les propriétés actuelles de cet objet CurrencyFormatter, à savoir le jeu de paramètres régionaux, le symbole de devise et le code ISO de la devise.

Par défaut, cette méthode a recours à la propriété currencyISOCode pour déterminer le symbole de devise et d’autres paramètres utilisés lors du formatage.

De nombreux pays et régions utilisent les mêmes symboles de devise pour différentes devises. Par exemple, les Etats-Unis, l’Australie, la Nouvelle-Zélande, le Canada et le Mexique utilisent tous le même symbole du dollar ($) pour différentes valeurs monétaires. Lorsque la devise de formatage diffère de la devise locale de l’utilisateur, il est préférable d’utiliser le code ISO comme chaîne de devise. Vous pouvez utiliser la méthode formattingWithCurrencySymbolIsSafe() pour vérifier si le code ISO de la devise à formater correspond à la propriété currencyISOCode du formateur.

Cette méthode permet de formater les nombres de grandes et de petites amplitudes. Cependant, le nombre de chiffres est limité à la précision fournie par le type de données de l’objet Number.

Dans cet exemple, les paramètres régionaux sollicités sont fr-CA, c’est-à-dire Français (Canada). Cet exemple suppose que le système d’exploitation de l’utilisateur prend en charge ces paramètres régionaux, et que par conséquent, il n’a pas recours à des paramètres régionaux par défaut. Pour fr-CA, la devise par défaut est le dollar canadien avec un code ISO de CAD. Par conséquent, lors du formatage d’une devise par défaut, CAD est utilisé comme symbole de devise. Lorsque le paramètre withCurrencySymbol est défini sur true, la propriété currencySymbol est utilisée pour formater le montant en devise. 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 $"

Le deuxième exemple présente une méthode de formatage d’un montant en devise en dollars canadiens à l’aide des paramètres régionaux par défaut. La méthode formattingWithCurrencySymbolIsSafe() permet de vérifier si la devise par défaut est le dollar canadien ; si tel est le cas, la méthode de formatage est utilisée avec le paramètre withCurrencySymbol défini sur true. Dans le cas contraire, la devise est définie sur Dollars canadiens avec un symbole de devise plus descriptif. L’exemple suivant montre la façon dont serait formatée la devise si les paramètres régionaux par défaut étaient soit Français (Canada) soit Anglais (Etats-Unis).

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 Détermine si le symbole de devise actuellement spécifié peut être utilisé lors du formatage des montants en devise.si le paramètre requestedISOCode est null. TypeErrorTypeErrortrue si la propriété currencyISOCode correspond au paramètre requestedISOCode ; false dans le cas contraire. BooleanrequestedISOCodeStringCode de devise ISO 4217 de trois lettres (par exemple, USD pour dollars américains, EUR pour euros, etc.). Doit contenir trois lettres en majuscules, de A à Z. Détermine si le symbole de devise actuellement spécifié peut être utilisé lors du formatage des montants en devise.

De nombreux pays et régions utilisent les mêmes symboles de devise. Il est possible d’utiliser cette méthode pour empêcher l’utilisation d’un symbole de devise ambigu, ou d’un symbole de devise ou d’un code ISO différent de celui attendu en raison de l’utilisation de paramètres régionaux par défaut.

Cette méthode est généralement utilisée pour déterminer s’il est nécessaire ou non d’afficher un symbole de devise local (si le montant est formaté en fonction de la devise par défaut de l’utilisateur) ou une chaîne de code ISO plus spécifique (si le montant est formaté en fonction d’une devise différente de la devise par défaut de l’utilisateur).

Cette méthode compare le paramètre requestedISOCode à la propriété currencyISOCode actuelle, et renvoie true si les chaînes sont égales ou false si elles ne sont pas. Lorsque les chaînes sont égales, si vous utilisez la méthode format() avec le paramètre withCurrencySymbol défini sur true, vous obtenez une chaîne de valeurs monétaires formatée à l’aide d’un symbole de devise unique pour les paramètres régionaux. Si cette méthode renvoie false, le recours à la méthode format() avec le paramètre withCurrencySymbol défini sur true peut entraîner l’utilisation d’un symbole de devise incorrect ou ambigu.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Si cette classe n’est pas prise en charge sur le système d’exploitation actuel, cette méthode renvoie une valeur nulle.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

parse Analyse une chaîne en un montant en devise et un symbole de devise.si le paramètre inputString est null. TypeErrorTypeErrorObjet CurrencyParseResult contenant la valeur numérique et le symbole ou la chaîne de devise. flash.globalization:CurrencyParseResultinputStringStringChaîne d’entrée à analyser. Analyse une chaîne en un montant en devise et un symbole de devise.

L’algorithme d’analyse utilise la valeur de la propriété decimalSeparator pour déterminer la partie intégrale et fractionnaire du nombre. Il utilise les valeurs des propriétés negativeCurrencyFormat et positiveCurrencyFormat pour déterminer l’emplacement du symbole ou de la chaîne de devise par rapport au montant en devise. En cas de montants négatifs, la valeur de la propriété negativeCurrencyFormat détermine l’emplacement du symbole négatif et indique si des parenthèses sont utilisées.

Si l’ordre du symbole de devise, le signe moins et le nombre dans la chaîne saisie ne correspondent pas au modèle identifié par les propriétés negativeCurrencyFormat et positiveCurrencyFormat, alors :

La propriété value de l’objet CurrencyParseResult renvoyé est définie sur NaN.
La propriété currencyString de l’objet CurrencyParseResult renvoyé est définie sur null.
La propriété lastOperationStatus est définie pour indiquer que l’analyse a échoué.

La chaîne saisie peut comporter des espaces, qui sont ignorés durant l’analyse.

L’analyse peut aboutir même en cas d’absence de symbole de devise. La partie de la chaîne correspondant au symbole de devise n’est pas validée. En cas d’absence de chaîne ou de symbole de devise, la propriété currencyString de l’objet CurrencyParseResult renvoyé est définie sur une chaîne vide.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

setCurrency Définit les propriétés currencyISOCode et currencySymbol de l’objet CurrencyFormatter.si le paramètre currencyISOCode ou currencySymbol est null. TypeErrorTypeErrordependent on the actual locale and operating system currencyISOCodeStringCode de devise ISO 4217 de trois lettres (par exemple, USD pour dollars américains, EUR pour euros, etc.). Doit contenir trois lettres en majuscules, de A à Z. currencySymbolString Chaîne ou symbole de devise à utiliser lors du formatage des valeurs monétaires. Il peut s’agir d’une chaîne vide. Définit les propriétés currencyISOCodeet currencySymbol de l’objet CurrencyFormatter.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Dans le cas contraire, les propriétés currencyISOCode et currencySymbol ne sont pas modifiées, et la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

actualLocaleIDName Nom de l’identificateur de paramètres régionaux actuel utilisé par cet objet CurrencyFormatter.String Nom de l’identificateur de paramètres régionaux actuel utilisé par cet objet CurrencyFormatter.

Il existe trois possibilités pour la valeur du nom, en fonction du système d’exploitation et de la valeur du paramètre requestedLocaleIDName transmis au constructeur CurrencyFormatter().

Si les paramètre régionaux requis n’étaient pas définis sur LocaleID.DEFAULT et que le système d’exploitation les prend en charge, le nom renvoyé est identique à la propriété requestedLocaleIDName.
Si LocaleID.DEFAULT a été utilisée comme valeur pour le paramètre requestedLocaleIDName transmis au constructeur, le nom des paramètres régionaux spécifié par le système d’exploitation de l’utilisateur est utilisé. La valeur LocaleID.DEFAULT préserve le paramètre personnalisé de l’utilisateur dans le système d’exploitation. La transmission d’une valeur explicite en tant que paramètre requestedLocaleIDName ne produit pas nécessairement le même résultat que l’utilisation de LocaleID.DEFAULT, même si le nom des deux identificateurs de paramètres régionaux est identique. Il est possible que l’utilisateur ait personnalisé les paramètres régionaux sur son ordinateur ; or, si vous demandez un identificateur de paramètres régionaux explicite au lieu d’utiliser LocaleID.DEFAULT, votre application ne récupérera pas ces paramètres personnalisés.

Par exemple :
var fmt:CurrencyFormatter = new CurrencyFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName;
Dans l’exemple ci-dessus, aliName représente le nom des paramètres régionaux correspondant aux paramètres définis par l’utilisateur dans le système d’exploitation actuel (par exemple, "it-IT" si les paramètres régionaux de l’utilisateur sont définis sur Italien (Italie)) et non "i-default" (nom du paramètre LocaleID.DEFAULT).
Si le système ne prend pas en charge le paramètre requestedLocaleIDName spécifié dans le constructeur, un nom d’ID de paramètres régionaux par défaut est fourni.

Par exemple :
var fmt:CurrencyFormatter = new CurrencyFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName;
Si le système d’exploitation dans l’exemple ci-dessus ne prend pas en charge l’ID de paramètres régionaux "fr_CA", c’est-à-dire Français (Canada), des paramètres de substitution sont fournis. Dans ce cas, l’ID de paramètres régionaux par défaut est "fr-FR", c’est-à-dire Français (France).

currencyISOCode Les trois lettres du code de devise ISO 4217 correspondant aux paramètres régionaux actuellement spécifiés.Stringdependent on the actual locale and operating system Les trois lettres du code de devise ISO 4217 correspondant aux paramètres régionaux actuellement spécifiés.

Ce code est utilisé pour déterminer le symbole ou la chaîne de devise lors du formatage des montants en devise à l’aide de la méthode format() avec le paramètre withCurrencySymbol défini sur false.

Cette propriété est initialisée par le constructeur en fonction des paramètres régionaux actuellement spécifiés. En cas d’utilisation de paramètres régionaux par défaut, cette propriété indique le code de devise par défaut correspondant à ces paramètres.

currencySymbol Chaîne ou symbole de devise correspondant aux paramètres régionaux actuellement spécifiés.Stringdependent on the actual locale and operating system Chaîne ou symbole de devise correspondant aux paramètres régionaux actuellement spécifiés.

Cette propriété est utilisée en tant que symbole de devise lors du formatage des montants en devise à l’aide de la méthode format() avec le paramètre withCurrencySymbol défini sur true.

Cette propriété est initialisée par le constructeur en fonction des paramètres régionaux actuellement spécifiés. En cas d’utilisation de paramètres régionaux de substitution, cette propriété indique le code de devise par défaut correspondant à ces paramètres.

decimalSeparator Séparateur décimal utilisé pour le formatage ou l’analyse des montants en devise à décimales.Stringsi cette propriété se voit attribuer une valeur null. TypeErrorTypeErrordependent on the actual locale and operating system Séparateur décimal utilisé pour le formatage ou l’analyse des montants en devise à décimales.

Cette propriété est initialement définie en fonction des paramètres régionaux sélectionnés lors de la construction de l’objet formatter.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

digitsType Définit le jeu de caractères numériques utilisé lors du formatage des montants en devise.uintsi cette propriété se voit attribuer une valeur null. TypeErrorTypeErrordependent on the actual locale and operating system Définit le jeu de caractères numériques utilisé lors du formatage des montants en devise.

Selon les langues et les régions, différents jeux de caractères sont utilisés pour représenter les chiffres de 0 à 9. Cette propriété définit le jeu de chiffres à utiliser.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

fractionalDigits Nombre maximal de chiffres pouvant apparaître après le séparateur décimal.int0 Nombre maximal de chiffres pouvant apparaître après le séparateur décimal.

Les numéros sont arrondis au nombre de chiffres spécifié par cette propriété. Le modèle d’arrondi varie selon le système d’exploitation de l’utilisateur.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

groupingPattern Décrit le placement de séparateurs de groupes au sein de la chaîne de montants en devise formatée.Stringsi cette propriété se voit attribuer une valeur null. TypeErrorTypeError Décrit le placement de séparateurs de groupes au sein de la chaîne de montants en devise formatée.

Lorsque la propriété useGrouping est définie sur true, la propriété groupingPattern permet de définir le placement et le modèle utilisé pour le séparateur de groupes.

Le tableau ci-dessous présente des exemples de formatage du montant en devise 123456789.12 avec divers modèles de groupement. Le séparateur de groupes est une virgule, le séparateur décimal est un point et le signe dollar ($) représente le symbole de devise.

Modèle de groupementExemple de format3;* $123,456,789.123;2;*$12,34,56,789.123$123456,789.12

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

groupingSeparator Caractère ou chaîne utilisé(e) pour le séparateur de groupes.Stringsi cette propriété se voit attribuer une valeur null. TypeErrorTypeErrordependent on the actual locale and operating system Caractère ou chaîne utilisé(e) pour le séparateur de groupes.

La valeur de cette propriété est utilisée en tant que séparateur de groupes lors du formatage de montants en devise lorsque la propriété useGrouping est définie sur true. Cette propriété est initialement définie en fonction des paramètres régionaux sélectionnés lors de la construction de l’objet formatter.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

lastOperationStatus Etat de la dernière opération que cet objet CurrencyFormatter a effectuée.String Etat de la dernière opération que cet objet CurrencyFormatter a effectuée. La propriété lastOperationStatus est définie chaque fois que le constructeur ou une méthode de cette classe est appelé(e), ou qu’une autre propriété est définie. Pour les valeurs disponibles, voir la description de chaque méthode. leadingZero Indique si un montant en devise formaté est précédé d’un zéro lorsque celui-ci ne contient aucun nombre entier à gauche du séparateur décimal.Booleansi cette propriété se voit attribuer une valeur null. TypeErrorTypeErrordependent on the actual locale and operating system Indique si un montant en devise formaté est précédé d’un zéro lorsque celui-ci ne contient aucun nombre entier à gauche du séparateur décimal.

Par exemple, si le montant en devise est 0.321 et que cette propriété est définie sur true, le zéro est inclus dans la chaîne formatée. Si la propriété est définie sur false, le zéro n’est inclus. Dans ce cas, la chaîne inclut uniquement le séparateur décimal, suivi des chiffres décimaux, comme $.321.

Le tableau ci-dessous présente des exemples sur la façon dont les montants en devise sont formatés en fonction des valeurs de cette propriété, ainsi que des propriétés fractionalDigits et trailingZeros associées.

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

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

negativeCurrencyFormat Valeur numérique qui indique un modèle de formatage pour les montants en devise négatifs.uintsi la valeur assignée n’est pas comprise entre 0 et 15. ArgumentErrorArgumentErrordependent on the actual locale and operating system Valeur numérique qui indique un modèle de formatage pour les montants en devise négatifs. Ce modèle définit l’emplacement du symbole de devise et du symbole négatif ou des parenthèses par rapport à la partie numérique du montant en devise.

La valeur de cette propriété doit être l’une des constantes définies dans le tableau ci-dessous.

Le tableau ci-dessous récapitule les modèles de formatage disponibles pour les montants en devise négatifs. Lorsqu’un montant en devise est formaté avec la méthode format() :

Le symbole « ¤ » est remplacé par la valeur de la propriété currencyISOCode ou currencySymbol, selon la valeur du paramètre withCurrencySymbol transmis à la méthode format() ;
Le caractère « - » est remplacé par la valeur de la propriété negativeNumberSymbol ;
Le caractère « n » est remplacé par le montant en devise transmis à la méthode format().

Type de format de devise négatifModèle de formatage0(¤n)1-¤n2¤-n3¤n-4(n¤)5-n¤6n-¤7n¤-8-n ¤9-¤ n10n ¤-11¤ n-12¤ -n13n- ¤14(¤ n)15(n ¤)

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

negativeSymbol Symbole négatif utilisé lors du formatage des montants en devise négatifs.Stringsi cette propriété se voit attribuer une valeur null. TypeErrorTypeErrordependent on the actual locale and operating system Symbole négatif utilisé lors du formatage des montants en devise négatifs.

Ce symbole est utilisé avec le format de devise négatif lors du formatage d’un montant en devise inférieur à zéro. Il n’est pas utilisé dans des formats de devise négatifs qui n’incluent pas de signe négatif (notamment lorsque des montants en devise négatifs se trouvent entre parenthèses).

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

positiveCurrencyFormat Valeur numérique qui indique un modèle de formatage pour les montants en devise positifs.uintsi la valeur assignée n’est pas comprise entre 0 et 3. ArgumentErrorArgumentErrordependent on the actual locale and operating system Valeur numérique qui indique un modèle de formatage pour les montants en devise positifs. Ce format définit l’emplacement du symbole de devise par rapport à la partie numérique du montant en devise.

La valeur de cette propriété doit être l’une des constantes définies dans le tableau ci-dessous.

Le tableau ci-dessous récapitule les modèles de formatage disponibles pour les montants en devise positifs. Lorsqu’un montant en devise est formaté avec la méthode format() :

Le symbole « ¤ » est remplacé par la valeur de la propriété currencyISOCode ou currencySymbol, selon la valeur du paramètre withCurrencySymbol transmis à la méthode format() ;
Le caractère « n » est remplacé par le montant en devise transmis à la méthode format().

Type de format de devise positifModèle de formatage0¤n1n¤2¤ n3n ¤

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

requestedLocaleIDName Nom de l’identificateur de paramètres régionaux requis ayant été transmis au constructeur de cet objet CurrencyFormatter.String Nom de l’identificateur de paramètres régionaux requis ayant été transmis au constructeur de cet objet CurrencyFormatter.

trailingZeros Indique si le montant en devise formaté est suivi de zéros.Booleansi cette propriété se voit attribuer une valeur null. TypeErrorTypeErrordependent on the actual locale and operating system Indique si le montant en devise formaté est suivi de zéros.

Par exemple, si le montant en devise est 123.4, si cette propriété est définie sur true et si la propriété fractionalDigits est définie sur 3, la chaîne formatée affiche des zéros, comme suit : 123.400. Si cette propriété est définie sur false, aucun zéro n’est inclus et la chaîne affiche uniquement le séparateur décimal, suivi des chiffres décimaux (différents de zéro), comme suit : $123.4.

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

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

useGrouping Permet l’utilisation du séparateur de groupes lors du formatage des montants en devise.Boolean Permet l’utilisation du séparateur de groupes lors du formatage des montants en devise.

Lorsque la propriété useGrouping est définie sur true, les chiffres sont groupés et délimités par le caractère de séparation de groupes. Par exemple : $123,456,789

Lorsque la propriété useGrouping est définie sur false, les chiffres ne sont ni groupés ni séparés. Par exemple : $123456789

La propriété groupingSeparator définit le symbole à utiliser en tant que séparateur de groupes. La propriété groupingPattern définit le nombre de chiffres entre les séparateurs de groupes.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Collator La classe Collator permet la comparaison de chaînes en fonction des paramètres régionaux. Object La classe Collator permet la comparaison de chaînes en fonction des paramètres régionaux.

Cette classe utilise les services de comparaison de chaînes fournis par le système d’exploitation. Les comparaisons diffèrent selon l’identificateur de paramètres régionaux fourni lors de la création de l’occurrence de la classe. ActionScript stocke les chaînes à l’aide du jeu de caractères Unicode. Les opérateurs de comparaison de chaînes booléens (==, !=, <, <=, >, >=) utilisent les points de code Unicode pour la comparaison. Dans la plupart des cas, l’ordre de tri résultant ne correspond pas aux conventions d’une langue et d’une région spécifiques, et ne doit donc pas être utilisé pour classer les chaînes présentées dans une interface utilisateur. En revanche, les méthodes de comparaison dans cette classe fournissent un ordre conforme à ces conventions.

Voici quelques exemples où l’ordre de tri varie en fonction de la langue :

En anglais, le a minuscule est placé avant le A majuscule, et le A majuscule est placé avant le b minuscule.
En suisse, la lettre ö est placée après le z, tandis qu’en allemand, ö est placée après o.
En espagnol traditionnel, la lettre ch est considérée comme caractère unique, et est placée entre le c et le d.
Les caractères accentués en français sont classés en fonction de la dernière différence d’accent et non selon la première différence d’accent : par exemple, cote < côte < coté < côté au lieu de cote < coté < côte < côté.

Les ordres de tri peuvent différer au sein d’une même langue et d’une même région selon l’usage. Par exemple, un autre ordre différent est utilisé en allemand pour classer les noms d’un annuaire téléphonique et les mots d’un dictionnaire. En chinois et japonais, il existe plusieurs manières de classer les caractères idéographiques : selon la prononciation ou en fonction du radical idéographique et du nombre de contours utilisés dans le glyphe. En espagnol et en géorgien, il existe une différence entre l’alphabet moderne et l’alphabet traditionnel.

Les méthodes de comparaison de cette classe proposent deux modes d’utilisation principaux. Le paramètre initialMode du constructeur Collator() contrôle ces modes. Le mode de tri par défaut est destiné au classement des éléments présentés à un utilisateur final. Dans ce mode, la comparaison est plus stricte afin de s’assurer que les éléments qui dans d’autres cas seraient identiques, sont classés de manière uniforme. Par exemple, les lettres majuscules et les lettres minuscules ne sont pas comparées de la même façon. En mode de correspondance, la comparaison est plus souple. Dans ce mode, les lettres minuscules et majuscules sont traitées de la même façon. Voici un exemple qui illustre ces deux modes :

var sortingCollator:Collator = new Collator("en-US", CollatorMode.SORTING); var words:Array = new Array("Airplane" , "airplane", "boat", "Boat"); words.sort(sortingCollator.compare); trace(words); var matchingCollator:Collator = new Collator("en-US", CollatorMode.MATCHING); if (matchingCollator.equals("Car", "car")) { trace("The words match!"); }

Même lorsqu’il fournit un identificateur de paramètres régionaux au constructeur (comme indiqué ci-dessus), le comportement du classement varie en fonction de l’utilisateur (c’est-à-dire des paramètres du système d’exploitation définis par l’utilisateur) et selon que le système a recours à des paramètres régionaux par défaut lorsque les paramètres régionaux requis ne sont pas pris en charge.

L’exemple suivant indique les résultats du tri, différents en fonction des paramètres régionaux. Cet exemple suit la procédure ci-dessous :

Effectue une itération sur un tableau de noms d’ID de paramètres régionaux, y compris l’ID de paramètres régionaux par défaut correspondant au système d’exploitation (comme spécifié par LocaleID.DEFAULT)
Crée un objet Collator pour chaque nom d’ID de paramètres régionaux en utilisant le mode de « tri » (valeur par défaut).
Affiche les noms d’ID de paramètres régionaux requis et actuel, ainsi que la valeur de la propriété lastOperationStatus afin que vous sachiez si un jeu de paramètres régionaux par défaut a été utilisé.
Trie un tableau de données à l’aide de chaque objet Collator et affiche les résultats. L’ordre est différent pour chaque jeu de paramètres régionaux.

package { import flash.globalization.Collator; import flash.globalization.LocaleID; public class CollatorExample1 { public var col:Collator; public function CollatorExample1():void { var localeNames:Array = [LocaleID.DEFAULT, "de-DE", "sv-SE", "fr-FR", "lt-LT", "es-ES"]; var testSortData:Array = [ "y ", "i ", "k ", // Latvian "acxa ", "acha ", "adxa ", // es_traditional "n ", "ö ", "o ", "z ", "vu ", "wo ", // sw "däd ", "daed ", // de "öf ", "of ", // de_dictionary "côte ", "coté " // fr ]; for each (var localeName:String in localeNames) { col = new Collator(localeName); trace("LocaleID requested: " + col.requestedLocaleIDName + "; actual: " + col.actualLocaleIDName); trace("Last Operation Status: " + col.lastOperationStatus ); var result:Array = testSortData.sort(col.compare); trace ("sorted data: " + result); } } } } Les exemples suivants montrent comment utiliser un objet Collator pour gérer le comportement des comparaisons de chaînes. Cet exemple suit la procédure ci-dessous :

Crée un objet Collator pour le jeu de paramètres régionaux par défaut de l’utilisateur à l’aide du mode de « mise en correspondance ».
Définit également la propriété Collator.ignoreDiacritics sur false et true.
Compare les jeux de chaînes qui contiennent des signes diacritiques, ainsi que des majuscules et des minuscules.
Indique la façon dont changent les comparaisons à mesure que les propriétés Collator.ignoreDiacritics et Collator.ignoreCase changent.

package { import flash.display.Sprite; import flash.globalization.Collator; import flash.globalization.CollatorMode; import flash.globalization.LocaleID; public class CollatorExample2 extends Sprite { public var col:Collator; public var testMatchData:Array = ["cote", "Cote", "cÃ´te", "cotÃ©"]; public var wordToMatch:String = "Cote"; public function CollatorExample2() { col = new Collator( LocaleID.DEFAULT, CollatorMode.MATCHING ); trace("LocaleID requested: " + col.requestedLocaleIDName + "; actual: " + col.actualLocaleIDName); trace("Last Operation Status: " + col.lastOperationStatus ); trace('\n' + "ignoreCase = " + col.ignoreCase); trace("ignoreDiacritics = " + col.ignoreDiacritics); compareString(testMatchData, wordToMatch) // All variations of the word cote match col.ignoreDiacritics = false; trace('\n' + "ignoreDiacritics = false"); compareString(testMatchData, wordToMatch) // Variations with different diacritics will not match col.ignoreCase = false; trace('\n' + "ignoreCase = false"); compareString(testMatchData, wordToMatch) // Variations with different case will not match } private function compareString(stringArray:Array, keyword:String):void { for each(var s:String in stringArray) { if(col.equals(s, keyword)) { trace(keyword + " = " + s); } } } } } Collator Construit un nouvel objet Collator en vue d’effectuer des comparaisons de chaînes en fonction des paramètres régionaux spécifiés.si le paramètre requestedLocaleIDName est null. TypeErrorTypeErrorsi le paramètre requestedLocaleIDName contient une valeur non valide. ArgumentErrorArgumentErrorrequestedLocaleIDNameStringChaîne à utiliser par cet objet Collator. initialModeStringsortingValeur de chaîne permettant de spécifier le mode de classement initial. La valeur par défaut est CollatorMode.SORTING. Voir la classe CollatorMode pour obtenir la liste des modes disponibles. Construit un nouvel objet Collator en vue d’effectuer des comparaisons de chaînes en fonction des paramètres régionaux spécifiés.

Si le système d’exploitation en cours ne prend pas en charge l’identificateur de paramètres régionaux transmis au paramètre requestedLocaleIDName, des paramètres régionaux de substitution sont spécifiés. Dans ce cas, la propriété lastOperationStatus est définie pour indiquer le type de paramètres de substitution.

Le paramètre initialMode définit plusieurs options de classement destinées à un usage général. Les valeurs définies peuvent être les suivantes :

CollatorMode.SORTING : définit des options de classement à des fins de tri linguistique généraux, par exemple le tri d’une liste de chaînes de texte présentées à un utilisateur final. Dans ce mode, les différences entre majuscules et minuscules, caractères accentués et autres différences spécifiques aux paramètres régionaux sont prises en compte lors de la comparaison de chaînes.
CollatorMode.MATCHING : définit des options de classement pour un usage général, notamment pour déterminer si deux chaînes sont équivalentes. Dans ce mode, les différences entre majuscules et minuscules, caractères accentués, etc., sont ignorées lors de la comparaison de chaînes.

Voici un exemple d’une liste triée créée à l’aide d’un objet Collator, dont l’identificateur de paramètres régionaux est "en-US", c’est-à-dire Anglais (Etats-Unis), et dont le mode est défini sur CollatorMode.SORTING :

AaÄäＡａAEaeÆæBbＢｂCcçＣｃ

Comme indiqué ci-dessus, tous les caractères sont traités comme ayant des valeurs différentes, mais en ordre linguistique.

A a Ä ä ＡａAE ae Æ æB b ＢｂC c ç Ｃｃ

Légende : les caractères dans une même ligne sont considérés comme caractères équivalents lors de la comparaison ou du tri. Par exemple, le caractère « a » (U+0040 = LETTRE LATINE A EN MINUSCULE) et le caractère « Ä » (U+00C4 = LETTRE LATINE A EN MAJUSCULE AVEC TREMA) sont considérés comme égaux.

Comme indiqué ci-dessus, certains caractères sont en ordre linguistique et sont traités comme ayant la même valeur de caractère.

Pour un contrôle plus précis sur l’ordre de tri, vous pouvez modifier les propriétés de l’objet Collator, telles que Collator.ignoreCase ou Collator.ignoreDiacritics.

Pour référence, voici un exemple de tri effectué à l’aide de la méthode standard Array.sort(), qui n’est pas basée sur les paramètres régionaux :

AAEBCaaebcÄÆäæçＡＢａｂ

Comme vous pouvez le voir ci-dessus, tous les caractères sont triés simplement dans l’ordre des valeurs numériques Unicode. Ce classement n’a pas beaucoup de sens d’un point de vue linguistique.

Pour utiliser les préférences du systèmes d’exploitation de l’utilisateur, transmettez la valeur statique LocaleID.DEFAULT du paramètre requestedLocaleIDName au constructeur.

Certains paramètres régionaux prennent en charge plusieurs variantes d’ordre de tri. Par exemple, la langue allemande utilise un ordre de tri pour les répertoires téléphoniques et un ordre de tri différent pour les dictionnaires. En chinois, les mots sont généralement pris en charge par la translittération des caractères dans le pinyin. Il est possible de sélectionner ces divers ordres de tri en incluant mot-clé "collation" dans la chaîne transmise dans le paramètre requestedLocaleIDName au constructeur.

var germanPhonebook:LocaleID = new LocaleID("de-DE@collation=phonebook"); var chinesePinyin:LocaleID = new LocaleID("zh-Hant@collation=pinyin");

Les valeurs possibles de la chaîne de classement sont les suivantes (les langues correspondantes sont indiquées entre parenthèses) :

Chaîne de classementDescriptionstandardClassement par défaut pour chaque langue. phonebookPour un classement de type annuaire téléphonique (utilisé en allemand).pinyinClassement pinyin pour les caractères latins et CJK, c’est-à-dire un classement pour les caractères CJK basé sur une translittération caractère par caractère dans un pinyin. (utilisé pour le chinois)traditionalPour un alphabet de style traditionnel (utilisé en espagnol) strokeClassement pinyin pour les caractères latins, ordre de tracé du trait pour les caractères CJK (utilisé pour le chinois).direct(utilisé pour l’hindi) big5hanClassement pinyin pour les caractères latins, classement selon le jeu de caractères BIG5 pour les caractères CJK. (utilisé pour le chinois) gb2312han Classement pinyin pour les caractères latins, classement selon le jeu de caractères gb2312han pour les caractères CJK. (utilisé pour le chinois) unihanClassement pinyin pour les caractères latins, ordre de tracé du radical Unihan pour les caractères CJK. (utilisé pour le chinois)

Si la plate-forme hôte ne prend pas en charge le type de classement requis, un classement de substitution est utilisé et la propriété lastOperationStatus est définie pour indiquer le recours à une valeur de substitution. Vous pouvez utiliser la propriété actualLocaleIDName pour déterminer la valeur ayant été utilisée comme valeur de secours, comme indiqué dans l’exemple suivant :

var collator:Collator = new Collator("fr-FR"); if (collator.lastOperationStatus == LastOperationStatus.USING_FALLBACK_WARNING) { trace ("Using fallback locale: " + collator.actualLocaleIDName); }

Lorsque le constructeur se termine avec succès, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Lorsque l’identificateur de paramètres régionaux requis n’est pas disponible, la propriété lastOperationStatus est définie sur l’une des valeurs suivantes :

LastOperationStatus.USING_FALLBACK_WARNING
LastOperationStatus.USING_DEFAULT_WARNING

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

compare Compare deux chaînes et renvoie un nombre entier indiquant si la première chaîne est inférieure, égale ou supérieure à la deuxième chaîne.lorsqu’un paramètre requis est null. TypeErrorTypeErrorlorsqu’un paramètre contient une valeur non valide. ArgumentErrorArgumentErrorNombre entier indiquant si la première chaîne est inférieure, égale ou supérieure à la deuxième chaîne.

Si la valeur renvoyée est négative, string1 est inférieure à string2.
Si la valeur renvoyée est zéro, string1 est égale à string2.
Si la valeur renvoyée est positive, string1 est supérieure à string2.

intstring1StringPremière chaîne de comparaison. string2StringDeuxième chaîne de comparaison. Compare deux chaînes et renvoie un nombre entier indiquant si la première chaîne est inférieure, égale ou supérieure à la deuxième chaîne. La comparaison utilise les règles de tri de l’identificateur de paramètres régionaux spécifié dans le constructeur Collator().

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

equals Compare deux chaînes et renvoie une valeur booléenne indiquant si les chaînes sont égales.lorsqu’un paramètre requis est null. TypeErrorTypeErrorlorsqu’un paramètre contient une valeur non valide. ArgumentErrorArgumentErrorValeur booléenne indiquant si les chaînes sont égales (true) ou ne le sont pas (false). Booleanstring1StringPremière chaîne de comparaison. string2StringDeuxième chaîne de comparaison. Compare deux chaînes et renvoie une valeur booléenne indiquant si les chaînes sont égales. La comparaison utilise les règles de tri de l’identificateur de paramètres régionaux spécifié dans le constructeur Collator().

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Si cette classe n’est pas prise en charge sur le système d’exploitation, cette méthode renvoie une valeur nulle.

actualLocaleIDName Nom de l’identificateur de paramètres régionaux actuel utilisé par cet objet Collator.String Nom de l’identificateur de paramètres régionaux actuel utilisé par cet objet Collator.

Il existe trois possibilités pour la valeur du nom, en fonction du système d’exploitation et de la valeur du paramètre requestedLocaleIDName transmis au constructeur Collator().

Si les paramètre régionaux requis n’étaient pas définis sur LocaleID.DEFAULT et que le système d’exploitation les prend en charge, le nom renvoyé est identique à la propriété requestedLocaleIDName.
Si LocaleID.DEFAULT a été utilisée comme valeur pour le paramètre requestedLocaleIDName transmis au constructeur, le nom des paramètres régionaux spécifié par le système d’exploitation de l’utilisateur est utilisé. La valeur LocaleID.DEFAULT préserve le paramètre personnalisé de l’utilisateur dans le système d’exploitation. La transmission d’une valeur explicite en tant que paramètre requestedLocaleIDName ne produit pas nécessairement le même résultat que l’utilisation de LocaleID.DEFAULT, même si le nom des deux identificateurs de paramètres régionaux est identique. Il est possible que l’utilisateur ait personnalisé les paramètres régionaux sur son ordinateur ; or, si vous demandez un identificateur de paramètres régionaux explicite au lieu d’utiliser LocaleID.DEFAULT, votre application ne récupérera pas ces paramètres personnalisés.

Par exemple :
var fmt:Collator = new Collator(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName;
Dans l’exemple ci-dessus, aliName représente le nom des paramètres régionaux correspondant aux paramètres définis par l’utilisateur dans le système d’exploitation actuel (par exemple, "it-IT" si les paramètres régionaux de l’utilisateur sont définis sur Italien (Italie)) et non "i-default" (nom du paramètre LocaleID.DEFAULT).
Si le système ne prend pas en charge le paramètre requestedLocaleIDName spécifié dans le constructeur, un nom d’ID de paramètres régionaux par défaut est fourni.

Par exemple :
var fmt:Collator = new Collator("fr-CA"); var aliName:String = fmt.actualLocaleIDName;
Si le système d’exploitation dans l’exemple ci-dessus ne prend pas en charge l’ID de paramètres régionaux "fr_CA", c’est-à-dire Français (Canada), des paramètres de substitution sont fournis. Dans ce cas, la variable aliName contient l’ID de paramètres régionaux de substitution "fr-FR", c’est-à-dire Français (France).

ignoreCase Lorsque cette propriété est définie sur true, les chaînes identiques, ainsi que les chaînes dont l’unique différence réside dans la casse typographique, sont considérées comme égales.Boolean<code>true</code> when the <code>Collator()</code> constructor's <code>initialMode</code> parameter is set to <code>Collator.MATCHING</code>. <code>false</code> when the <code>Collator()</code> constructor's <code>initialMode</code> parameter is set to Collator.SORTING. Lorsque cette propriété est définie sur true, les chaînes identiques, ainsi que les chaînes dont l’unique différence réside dans la casse typographique, sont considérées comme égales. Par exemple, compare("ABC", "abc") renvoie true lorsque la propriété ignoreCase est définie sur true.

La conversion de casse de la chaîne suit les règles des paramètres régionaux spécifiés.

Lorsque la propriété ignoreCase est définie sur false, les caractères majuscules et minuscules ne sont pas égaux.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

ignoreCharacterWidth Lorsque cette propriété est définie sur true, les formes à pleine chasse et à demi-chasse de certains caractères chinois et japonais sont considérées comme égales.Booleanfalse Lorsque cette propriété est définie sur true, les formes à pleine chasse et à demi-chasse de certains caractères chinois et japonais sont considérées comme égales.

Pour assurer la compatibilité avec les normes existantes relatives aux jeux de caractères chinois et japonais, Unicode fournit des codes de caractères pour certains caractères à pleine chasse et à demi-chasse. Par exemple, lorsque la propriété ignoreCharacterWidth est définie sur true, compare("Ａｱ", "Aア") renvoie true.

Si la propriété ignoreCharacterWidth est définie sur false, les caractères à pleine chasse et à demi-chasse ne sont pas égaux.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

ignoreDiacritics Lorsque cette propriété est définie sur true, les chaînes qui utilisent les mêmes caractères de base, mais des accents différents ou d’autres signes diacritiques, sont considérées comme égales.Booleanfalse Lorsque cette propriété est définie sur true, les chaînes qui utilisent les mêmes caractères de base, mais des accents différents ou d’autres signes diacritiques, sont considérées comme égales. Par exemple, compare("coté", "côte") renvoie true lorsque la propriété ignoreDiacritics est définie sur true.

Lorsque la propriété ignoreDiacritics est définie sur false, les caractères de base possédant des signes diacritiques ou des accents ne sont pas considérés comme égaux.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

ignoreKanaType Lorsque cette propriété est définie sur true, les chaînes dont l’unique différence réside dans le type de caractères kana utilisés sont considérées comme égales.Booleanfalse Lorsque cette propriété est définie sur true, les chaînes dont l’unique différence réside dans le type de caractères kana utilisés sont considérées comme égales. Par exemple, compare("カナ", "かな") renvoie true lorsque la propriété ignoreKanaType est définie sur true.

Si la propriété ignoreKanaType est définie sur false, les caractères hiragana et katakana qui font référence à la même syllabe ne sont pas égaux.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

ignoreSymbols Lorsque cette propriété est définie sur true, les caractères de symbole, tels qu’espaces, symboles de devises, symboles mathématiques et autres types de symboles, ne sont pas pris en compte lors du tri ou de la correspondance.Booleanfalse Lorsque cette propriété est définie sur true, les caractères de symbole, tels qu’espaces, symboles de devises, symboles mathématiques et autres types de symboles, ne sont pas pris en compte lors du tri ou de la correspondance. Par exemple, les chaînes "OBrian", "O’Brian" et "o Brian" sont toutes considérées comme égales lorsque la propriété ignoreSymbols est définie sur true.

Si la propriété ignoreSymbols est définie sur false, les caractères de symboles sont pris en compte lors des comparaisons de chaînes.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

lastOperationStatus Etat de la dernière opération que cet objet Collator a effectuée.String Etat de la dernière opération que cet objet Collator a effectuée. La propriété lastOperationStatus est définie chaque fois que le constructeur ou une méthode de cette classe est appelé, ou qu’une autre propriété est définie. Pour les valeurs disponibles, voir la description de chaque méthode. numericComparison Contrôle la manière dont les valeurs numériques intégrées aux chaînes sont gérées lors de la comparaison des chaînes.Booleanfalse Contrôle la manière dont les valeurs numériques intégrées aux chaînes sont gérées lors de la comparaison des chaînes.

Lorsque la propriété numericComparison est définie sur true, la méthode de comparaison convertit les nombres figurant dans les chaînes en valeurs numériques en vue de le comparaison.

Lorsque cette propriété est définie sur false, la comparaison considère les nombres en tant que codes de caractères et les classe conformément aux règles de tri des caractères des paramètres régionaux spécifiés.

Par exemple, lorsque cette propriété est définie sur true pour l’identificateur de paramètres régionaux "en-US", les chaînes "version1", "version10" et "version2" sont classées dans l’ordre suivant : version1 < version2 < version10.

Lorsque cette propriété est définie sur false pour "en-US", ces mêmes chaînes sont classées dans l’ordre suivant : version1 < version10 < version2.

Lorsque cette propriété se voit attribuer une valeur et en l’absence d’erreurs ou d’avertissements, la propriété lastOperationStatus est définie sur :

LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

requestedLocaleIDName Nom de l’identificateur de paramètres régionaux ayant été transmis au constructeur de cet objet Collator.String Nom de l’identificateur de paramètres régionaux ayant été transmis au constructeur de cet objet Collator.