DateTimeFormatter  - AS3 Flex

Nom de l’identificateur de paramètres régionaux utilisé par cet objet de classe. Il s’agit des paramètres régionaux qui sont utilisés pour accéder à la fonctionnalité et aux données de formatage à partir du système d’exploitation.

Si les paramètres régionaux définis par le style des paramètres régionaux ne sont pas disponibles, la valeur de la propriété actualLocaleIDName est différente de la valeur du style des paramètres régionaux. Elle indique les paramètres régionaux de secours qui sont utilisés. Si le style de paramètres régionaux a été défini sur LocaleID.DEFAULT, le nom des paramètres régionaux spécifié par le système d’exploitation de l’utilisateur est utilisé.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Le style de date de cette instance de DateTimeFormatter. Le style de date permet d’extraire un modèle de formatage d’heure prédéfini et spécifique aux paramètres régionaux à partir du système d’exploitation. Lors du formatage d’une date, le style locale, la propriété timeStyle et la propriété dateStyle déterminent le format de la date. La valeur du style de date peut être définie des deux façons suivantes : en attribuant une valeur à la propriété dateStyle ou à la propriété dateTimePattern.

Les valeurs possibles de cette propriété sont définies par la classe flash.globalization.DateTimeStyle. Les valeurs possibles pour la propriété dateStyle sont les suivantes :

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

Si la propriété dateTimePattern se voit attribuer une valeur, comme effet secondaire, la propriété dateStyle est définie sur DateTimeStyle.CUSTOM.

La valeur par défaut est DateTimeStyle.LONG.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

La chaîne de modèle utilisée par l’objet DateTimeFormatter pour formater la date et l’heure.

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

1. En définissant les propriétés dateStyle et timeStyle.
2. En définissant la propriété dateTimePattern.

Si cette propriété se voit attribuer une valeur directement, comme effet secondaire, les styles d’heure et de date actuels sont remplacés et définis sur la valeur DateTimeStyle.CUSTOM.

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

La valeur par défaut est "EEEE, MMMM dd, yyyy h:mm:ss a".

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Chaîne renvoyée par la méthode format() lorsqu’une erreur se produit.

Si la propriété errorText n’a pas la valeur null et qu’une erreur se produit lors du formatage d’une date, la méthode format renverra la chaîne affectée à cette propriété.

      var dtf:DateTimeFormatter = new DateTimeFormatter();
      dtf.setStyle("locale", "en-US");
      dtf.errorText = "----"
      trace(dtf.format("abc"));  // ----
      

La valeur par défaut est null.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Etat de la dernière opération que cet objet de classe 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.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Le style d’heure de cette instance de DateTimeFormatter. Le style d’heure permet d’extraire un modèle de formatage d’heure prédéfini et spécifique aux paramètres régionaux à partir du système d’exploitation. Lors du formatage d’une date, le style locale, la propriété timeStyle et la propriété dateStyle déterminent le format de la date. La valeur du style d’heure peut être définie des deux façons suivantes : en attribuant une valeur à la propriété timeStyle ou à la propriété dateTimePattern.

La valeur de la propriété est définie par la classe flash.globalization.DateTimeStyle. Les valeurs possibles pour la propriété timeStyle sont les suivantes :

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

Si la propriété dateTimePattern se voit attribuer une valeur, comme effet secondaire, la propriété dateStyle est définie sur DateTimeStyle.CUSTOM.

La valeur par défaut est DateTimeStyle.LONG.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Indicateur booléen permettant de contrôler si les valeurs de date et d’heure locales ou UTC sont utilisées lors du formatage d’une date. Si la propriété useUTC est définie sur true, les valeurs UTC sont utilisées. Si la valeur est définie sur false, les valeurs de date et d’heure du fuseau horaire actuel du système d’exploitation sont utilisées.

La valeur par défaut est false.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Construit un nouvel objet DateTimeFormatter en vue de formater les dates et les heures conformément aux conventions des paramètres régionaux en vigueur, ainsi qu’aux styles de formatage de la date et de l’heure fournis.

Les paramètres régionaux pour cette classe sont fournis par le style de paramètres régionaux. Le style de paramètres régionaux peut être défini de plusieurs manières :

• En utilisant la classe dans une déclaration MXML et en héritant les paramètres régionaux à partir du document qui contient la déclaration.
Exemple :

      <fx:Declarations> 
             <s:DateTimeFormatter id="df" />
      </fx:Declarations>

• En utilisant une déclaration MXML et en spécifiant la valeur des paramètres régionaux dans la liste des affectations.
Exemple :

      <fx:Declarations> 
          <s:DateTimeFormatter id="df_Japanese" locale="ja-JP" />
      </fx:Declarations>

• L’appel de la méthode setStyle. Par exemple :

        df.setStyle("locale", "ja-JP")

• En héritant le style à partir d’un composant UIComponent en appelant la méthode addStyleClient() du composant UIComponent.

Si le style locale n’est défini par aucune des techniques ci-dessus, l’instance de cette classe sera ajoutée comme StyleClient à topLevelApplication. Elle hérite par conséquent du style locale de l’objet topLevelApplication lors de l’appel de l’accesseur de lecture de la propriété dépendante de locale ou de la méthode dépendante de locale.

La plupart des propriétés de cette classe sont définies automatiquement en fonction du style de paramètres régionaux. Si le style des paramètres régionaux est modifié, toutes les propriétés qui n’ont pas été explicitement définies seront également mises à jour en fonction des nouveaux paramètres régionaux. Notez que les véritables paramètres régionaux utilisés sont spécifiés par la propriété actualLocaleIDName.

Eléments de l’API associés

Formate une chaîne d’affichage pour un objet qui spécifie une date dans l’heure locale de l’utilisateur ou dans l’heure UTC.

Un objet Date possède deux ensembles de valeurs de date et d’heure, celles exprimées dans l’heure locale de l’utilisateur (date, day, fullYear, hours, minutes, month, et seconds) et celles exprimées dans l’heure UTC (dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC, et secondsUTC). La propriété booléenne useUTC contrôle quel ensemble de composants de date et d’heure est utilisé lors du formatage de la date. Le formatage sera effectué à l’aide des conventions des paramètres régionaux, tels qu’ils sont définis par la propriété de style locale et les propriétés dateStyle et timeStyle, ou la propriété dateTimePattern, spécifiée pour cette instance de DateTimeFormatter.

S’il se produit une erreur lors du formatage, en raison d’une valeur en entrée non valide ou d’une autre erreur, par défaut, la méthode format() renverra null. Cependant, si la propriété errorText n’a pas la valeur null, la valeur de la propriété errorText sera renvoyée. La propriété lastOperationStatus sera définie pour indiquer l’erreur qui s’est produite.

Paramètres

Eléments de l’API associés

Répertorie tous les noms des ID de paramètres régionaux pris en charge par cette classe. Il s’agit de la liste des paramètres régionaux pris en charge par le système d’exploitation, et non d’une liste de paramètres régionaux pour laquelle la classe ResourceManager dispose de ressources.

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.

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.

Paramètres

Eléments de l’API associés

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.

Paramètres

Eléments de l’API associés