DateTimeAxis  - AS3 Flex

Détermine le positionnement des libellés le long de l’axe.

Lorsque la valeur est false, le graphique place toujours un libellé au début de l’axe. Par exemple, si les libellés doivent être affichés pour chaque mois et que le premier point de données est le 14 juillet, le premier libellé sera placé au niveau du 14 juillet. Lorsque la valeur est true, Flex commence par calculer l’unité de libellé, puis affiche le libellé pour le premier intervalle complet de cette unité. Par exemple, si le premier point de données correspond au 14 juillet et que les mois sont utilisés comme unité de libellé (unité définie explicitement ou par calcul dynamique), le premier libellé s’affiche au niveau du 1er août.

La valeur par défaut est true.

Spécifie l’intervalle entre les données du graphique, spécifié en unités dataUnits.

Par exemple, si la propriété dataUnits est définie sur "hours" et que la propriété dataInterval est définie sur 4, le graphique suppose qu’un intervalle de quatre heures sépare les données. Cette propriété influe sur la manière dont certaines séries (ColumnSeries et CandlestickSeries, entre autres) rendent leurs données. Elle influe également sur le choix automatique des libellés.

Eléments de l’API associés

Spécifie l’unité à utiliser pour représenter les données dans le graphique. La valeur doit être choisie parmi les valeurs suivantes :

• millisecondes
• secondes
• minutes
• heures
• jours
• semaines
• mois
• années

Cette valeur est utilisée de deux manières. Tout d’abord, lors du choix de l’unité de libellé adaptée, la classe DateTimeAxis ne choisit jamais une unité plus petite que les unités représentées par les données. Si la valeur de la propriété dataUnits est days, le graphique ne rend pas les libellés à chaque heure, quelles que soient les valeurs minimale et maximale de la plage.

Par ailleurs, la valeur de la propriété dataUnits est utilisée par certaines séries pour modifier le rendu. Ainsi, la plupart des séries de colonnes (ColumnSeries, BarSeries, CandlestickSeries et HLOCSeries, par exemple) utilisent la valeur de la propriété dataUnits pour déterminer la largeur de rendu de leurs colonnes.

Par exemple, si la propriété labelUnits de l’axe horizontal du contrôle ColumnChart est définie sur weeks et que sa propriété dataUnits est définie sur days, le contrôle ColumnChart rend chaque colonne à 1/7e de la distance entre les libellés.

Lorsque la propriété dataUnits est définie sur null, les séries de colonnes rendent leurs colonnes jour par jour, mais la classe DateTimeAxis choisit une unité plus appropriée lors de la génération des libellés.

La valeur par défaut est null.

Jours à désactiver dans une semaine. Toutes les dates du mois correspondant au jour spécifié sont désactivées. La valeur des éléments de ce tableau est comprise entre 0 (dimanche) et 6 (samedi). Par exemple, la valeur [ 0, 6 ] désactive le dimanche et le samedi.

Désactive un seul et plusieurs jours.

Cette propriété accepte un tableau d’objets en tant que paramètre. Chaque objet de ce tableau est un objet Date spécifiant un seul jour à désactiver, ou un objet contenant une des propriétés rangeStart et rangeEnd, voire les deux, dont les valeurs sont un objet Date. La valeur de ces propriétés décrit les limites de la période. Si l’une ou l’autre des propriétés est omise, la période est considérée comme illimitée dans le sens correspondant. Si vous ne spécifiez que la propriété rangeStart, toutes les dates qui se trouvent après la date spécifiée sont désactivées, y compris la date rangeStart. Si vous spécifiez uniquement la propriété rangeEnd, toutes les dates antérieures à la date spécifiée sont désactivées, y compris la date spécifiée par rangeEnd. Pour désactiver un jour précis, utilisez un objet Date spécifiant une date dans le tableau.

L’exemple suivant désactive le 11 janvier 2006, la période du 23 janvier au 10 février 2006, ainsi que toutes les dates à partir du 1er mars 2006.

disabledRanges="{[ new Date(2006,0,11), {rangeStart: new Date(2006,0,23), rangeEnd: new Date(2006,1,10)}, {rangeStart: new Date(2006,2,1)} ]}"

La valeur par défaut est [].

Lorsque la valeur est true, l’objet DateTimeAxis considère que toutes les valeurs de date sont dans le même fuseau horaire que l’ordinateur client exécutant l’application. Si la valeur est false, toutes les valeurs sont exprimées en temps universel (heure du méridien de Greenwich).

Spécifie le nombre d’unités labelUnits entre les valeurs des libellés le long de l’axe. Flex calcule l’intervalle si cette propriété est définie sur null.

La valeur par défaut est null.

Unités utilisées par l’axe pour générer les libellés. Par défaut, un objet DateTimeAxis prend en compte toutes les unités valides (millisecondes, secondes, minutes, heures, jours, semaines, mois ou années).

Si la propriété labelUnits n’est pas définie, le graphique n’utilise pas d’unité plus petite que la valeur de la propriété dataUnits pour rendre les libellés.

Spécifie la valeur maximale d’un libellé d’axe. Si la valeur est null, Flex détermine la valeur minimale à partir des données du graphique.

La valeur par défaut est null.

Spécifie la valeur minimale d’un libellé d’axe. Si la valeur est null, Flex détermine la valeur minimale à partir des données du graphique.

La valeur par défaut est null.

Spécifie le nombre d’unités minorTickUnits entre les graduations secondaires le long de l’axe. Si cette propriété est définie sur NaN, l’objet DateTimeAxis le calcule automatiquement.

La propriété minorTickInterval est normalement définie automatiquement sur 1. Cependant, si la propriété minorTickUnits correspond aux mêmes unités que la propriété dataUnits (qu’elle soit définie explicitement ou par calcul implicite), alors la propriété minorTickInterval correspond soit à 1, soit à dataInterval, la valeur la plus élevée étant prise en compte.

Unités prises en compte par l’axe lors de la génération des graduations secondaires. Par défaut, un objet DateTimeAxis prend en compte toutes les unités valides (millisecondes, secondes, minutes, heures, jours, semaines, mois ou années).

Si cette propriété n’est pas définie, le graphique détermine la valeur de la propriété minorTickUnits. Si l’intervalle de libellé est supérieur à 1, la propriété minorTickUnits est définie sur la valeur de la propriété labelUnits et la propriété minorTickInterval est définie sur 1. Si l’intervalle de libellé est égal à 1, la propriété minorTickUnits est définie sur la valeur inférieure la plus proche de la propriété labelUnits. Si elle est définie, la propriété minorTickUnits ne peut en aucun cas être plus petite que la valeur de la propriété dataUnits.

Spécifie une méthode personnalisant la valeur des points de données. Grâce à cette propriété, vous pouvez spécifier une méthode acceptant une valeur et renvoyant un objet Date. L’objet Date est ensuite utilisé dans l’objet DateTimeAxis du graphique. Vous pouvez ainsi fournir des chaînes d’entrée de données personnalisables et les convertir en objets Date que Flex peut interpréter dans l’objet DateTimeAxis.

Flex transmet un seul paramètre à la méthode d’analyse. Ce paramètre correspond à la valeur du point de données spécifié pour la série. Il s’agit généralement d’une chaîne représentant une date. Vous ne pouvez pas remplacer ce paramètre ni ajouter des paramètres supplémentaires.

Cet objet Date est immédiatement converti en valeur numérique, de sorte que les fonctions parseFunctions personnalisées puissent réutiliser le même objet Date et ainsi améliorer les performances. Par défaut, la classe DateTimeAxis utilise la fonctionnalité d’analyse de chaîne de la méthode Date.parse() de la norme ECMA.

      <mx:Script>
          import mx.collections.ArrayCollection;
          [Bindable] 
          public var aapl:ArrayCollection = new ArrayCollection([ 
              {date: "2005, 8, 1", close: 42.71},
              {date: "2005, 8, 2", close: 42.99},
              {date: "2005, 8, 3", close: 44}
          ]);
          
          public function myParseFunction(s:String):Date { 
              // Get an array of Strings from the comma-separated String passed in.
              var a:Array = s.split(",");
      
              // Create the new Date object. Note that the month argument is 0-based (with 0 being January).
              var newDate:Date = new Date(a[0],a[1]-1,a[2]);
              return newDate;
          }
      </mx:Script>
      <mx:LineChart id="mychart" dataProvider="{aapl}" showDataTips="true">
          <mx:horizontalAxis>
              <mx:DateTimeAxis dataUnits="days" parseFunction="myParseFunction"/>
          </mx:horizontalAxis>
          <mx:series>
              <mx:LineSeries yField="close" xField="date" displayName="AAPL"/>
          </mx:series>
      </mx:LineChart>
      

Champs de la structure DescribeData concernés par cet axe.

Largeur d’une unité de données unique, en pixels. Le type d’une unité de données est déterminé par la valeur de la propriété dataUnits.

Constructeur.

Crée un tableau de positions pour le tableau de graduations secondaires généré par cet axe. Les sous-classes doivent implémenter cette fonction. Cette fonction est appelée automatiquement par la classe NumericAxis. Il est recommandé d’accéder à la propriété minorTicks plutôt que d’appeler directement cette fonction.

Filtre un ensemble de valeurs de type arbitraire pour produire un ensemble de nombres qui peuvent être mappés.

Paramètres

Fonction de formatage par défaut utilisée lorsque l’axe rend les valeurs à partir d’unités labelUnits journalières. Si vous écrivez une classe DateTimeAxis personnalisée, vous pouvez remplacer cette méthode pour spécifier un autre formatage par défaut.

Vous n’appelez pas cette méthode directement. En fait, Flex appelle cette méthode avant de rendre le libellé, afin d’obtenir la chaîne à afficher.

Paramètres

Fonction de formatage par défaut utilisée lorsque l’axe rend les valeurs en utilisant les millisecondes comme unité labelUnits. Si vous écrivez une classe DateTimeAxis personnalisée, vous pouvez remplacer cette méthode pour spécifier un autre formatage par défaut.

Vous n’appelez pas cette méthode directement. En fait, Flex appelle cette méthode avant de rendre le libellé, afin d’obtenir la chaîne à afficher.

Paramètres

Fonction de formatage par défaut utilisée lorsque l’axe rend les valeurs en utilisant les minutes comme unité labelUnits. Si vous écrivez une classe DateTimeAxis personnalisée, vous pouvez remplacer cette méthode pour spécifier un autre formatage par défaut.

Vous n’appelez pas cette méthode directement. En fait, Flex appelle cette méthode avant de rendre le libellé, afin d’obtenir la chaîne à afficher.

Paramètres

Fonction de formatage par défaut utilisée lorsque l’axe rend les valeurs en utilisant les mois comme unité labelUnits. Si vous écrivez une classe DateTimeAxis personnalisée, vous pouvez remplacer cette méthode pour spécifier un autre formatage par défaut.

Vous n’appelez pas cette méthode directement. En fait, Flex appelle cette méthode avant de rendre le libellé, afin d’obtenir la chaîne à afficher.

Paramètres

Fonction de formatage par défaut utilisée lorsque l’axe rend les valeurs en utilisant les secondes comme unité labelUnits. Si vous écrivez une classe DateTimeAxis personnalisée, vous pouvez remplacer cette méthode pour spécifier un autre formatage par défaut.

Vous n’appelez pas cette méthode directement. En fait, Flex appelle cette méthode avant de rendre le libellé, afin d’obtenir la chaîne à afficher.

Paramètres

Fonction de formatage par défaut utilisée lorsque l’axe rend les valeurs en utilisant les années comme unité labelUnits. Si vous écrivez une classe DateTimeAxis personnalisée, vous pouvez remplacer cette méthode pour spécifier un autre formatage par défaut.

Vous n’appelez pas cette méthode directement. En fait, Flex appelle cette méthode avant de rendre le libellé, afin d’obtenir la chaîne à afficher.

Paramètres

Appelée lorsqu’un objet AxisRenderer est incapable de rendre correctement les libellés sans chevauchement et qu’il souhaite que l’objet Axis réduise l’ensemble de libellés. Les deux libellés qui se chevauchent sont transmis à la méthode.

Paramètres

Mappe à l’espace d’écran un ensemble de valeurs issues de l’espace de données.

Paramètres