DateTimeAxis  - AS3 Flex

軸に沿ったラベルの配置を決定します。

false の場合は、グラフでは常に軸の先頭にラベルが表示されます。 例えば、月ごとのラベルを生成する場合に、最初のデータポイントが 7 月 14 日であれば、最初のラベルは 7 月 14 日のものとなります。 true の場合は、まずラベルの単位が計算されてから、この単位の整数の間隔にラベルが表示されます。 例えば、最初のデータポイントが 7 月 14 日であり、ラベル単位を月にしている場合は（明示的に設定、または動的に計算）、最初のラベルは 8 月 1 日となります。

デフォルト値： true。

dataUnits で指定されたグラフ内のデータ間の間隔を指定します。

例えば、dataUnits プロパティが "hours" に、dataInterval プロパティが 4 に設定されている場合、グラフではデータが 3 時間おきに発生すると見なされます。 これは、一部の系列（ColumnSeries および CandlestickSeries など）によるデータのレンダリングに影響を及ぼします。 また、ラベルの自動選択方法にも影響します。

関連する API エレメント

グラフ内でデータの表示に使用する単位を指定します。 指定できる値は、以下のいずれかです。

• milliseconds
• seconds
• minutes
• hours
• days
• weeks
• months
• years

この値は、次の 2 つの方法で使用することができます。 まず、適切なラベル単位を選択する場合、DateTimeAxis では、データが表示されている単位より小さい単位は選択されません。 dataUnits プロパティの値が days の場合、最小値と最大値の間の範囲にかかわらず、グラフでは時間ごとのラベルはレンダリングされません。

次に、dataUnits プロパティの値はいくつかの系列で使用され、それらの系列のレンダリングに影響します。 具体的には、ほとんどの縦棒系列（ColumnSeries、BarSeries、CandlestickSeries、および HLOCSeries など）で dataUnits プロパティにより、レンダリングされる縦棒の幅が決定されます。

例えば、ColumnChart コントロールの水平軸で labelUnits プロパティが weeks に、dataUnits プロパティが days に設定されている場合は、ColumnChart により、各縦棒が各ラベル間の間隔の 1/7 でレンダリングされます。

dataUnits プロパティを null に設定すると、縦棒系列により日単位で縦棒がレンダリングされますが、DateTimeAxis により、ラベルの生成時に適切な単位が選択されます。

デフォルト値： null。

無効にする曜日です。指定した曜日に該当するその月のすべての日付が無効になります。この配列のエレメントは 0（日曜日）から 6（土曜日）の範囲の値です。 例えば、[ 0, 6 ] という値を設定すると、日曜日と土曜日が無効になります。

1 日または複数の日を無効にします。

このプロパティは、パラメーターとしてオブジェクトの配列を受け入れます。 この配列にあるオブジェクトはそれぞれ Date オブジェクトです。無効にする 1 日を指定するか、あるいは、Date オブジェクトの値を持つ rangeStart プロパティおよび rangeEnd プロパティのいずれか一方または両方を含むオブジェクトを指定します。 これらのプロパティの値は、日付範囲の先頭と末尾を示します。 いずれかのプロパティを省略した場合、そちら側の境界には制限がなくなります。 rangeStart のみを指定した場合は、rangeStart の日付を含めて、指定した日付より後の日付がすべて無効になります。 rangeEnd のみを指定した場合は、rangeEnd の日付を含めて、指定した日付より前の日付がすべて無効になります。 1 日のみを無効にするには、Array 内の日付を指定する単一の Date オブジェクトを使用します。

次の例では、2006 年 1 月 11 日と、2006 年 1 月 23 日 ～ 2 月 10 日の範囲、および 2006 年 3 月 1 日以降のすべての日付を無効にしています。

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

デフォルト値： []。

true に設定された場合は、DateTimeAxis により、すべてのデータ値がアプリケーションを実行するクライアントマシンのタイムゾーンにあると見なされます。 false に設定された場合、すべての値は世界標準時（グリニッジ標準時）になります。

軸に沿ったラベル間の labelUnits の数を指定します。 このプロパティが null に設定されている場合、Flex により間隔が計算されます。

デフォルト値： null。

軸によりラベルの生成に使用される単位です。 デフォルトでは、DateTimeAxis ではすべての有効な単位（milliseconds、seconds、minutes、hours、days、weeks、months、または years）が考慮されます。

ただし、labelUnits プロパティが設定されていない場合は、グラフでのラベルのレンダリングに、dataUnits プロパティの値より小さい単位は使用されません。

軸のラベルの最大値を指定します。 null の場合は、グラフのデータから最小値が決定されます。

デフォルト値： null。

軸のラベルの最小値を指定します。 null の場合は、グラフのデータから最小値が決定されます。

デフォルト値： null。

軸に沿った小さな目盛りの間の minorTickUnits の数を指定します。 このプロパティが NaN に設定されている場合は、DateTimeAxis により自動的に計算されます。

通常は、minorTickInterval プロパティが自動的に 1 に設定されます。 ただし、minorTickUnits プロパティが dataUnits プロパティと（明示的な設定または暗黙の計算により）同じ単位である場合は、minorTickInterval プロパティが最大値の 1 または dataInterval となります。

小さな目盛りの生成時に、軸により考慮される単位です。 デフォルトでは、DateTimeAxis ではすべての有効な単位（milliseconds、seconds、minutes、hours、days、weeks、months、または years）が考慮されます。

このプロパティが設定されていない場合は、グラフにより minorTickUnits プロパティの値が決定されます。 ラベルの間隔が 1 より大きい場合は、minorTickUnits プロパティが labelUnits プロパティの値に、minorTickInterval プロパティが 1 に設定されます。ラベル間隔が 1 の場合は、minorTickUnits プロパティが labelUnits プロパティの次に小さい単位に設定されます。 設定された場合は、minorTickUnits プロパティが dataUnits プロパティの値より小さくなることはありません。

データポイントの値をカスタマイズするメソッドを指定します。このプロパティを使用して、値を受け入れて Date オブジェクトを返すメソッドを指定します。その後で、Date オブジェクトをグラフの DateTimeAxis オブジェクトの中で使用します。これにより、カスタマイズ可能な日付入力ストリングを提供して、これを Date オブジェクトに変換できます。Flex はこの Date オブジェクトを解釈し、DateTimeAxis で使用できます。

解析メソッドには、1 つのパラメーターのみが渡されます。 このパラメーターは、データ系列に指定したデータポイントの値です。 通常は、何らかの形式の日付を表すストリングです。このパラメーターをオーバーライドすることも、他のパラメーターを追加することもできません。

この Date オブジェクトは直ちに数値に変換されるため、カスタム parseFunctions は同じ Date オブジェクトを再使用することができ、パフォーマンスの向上に役立ちます。 デフォルトでは、DateTimeAxis には、ECMA 標準 Date.parse() メソッドのストリング解析機能が使用されます。

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

この軸に影響する DescribeData 構造体のフィールドです。

ピクセルで表された 1 つのデータ単位の幅です。 データ型は dataUnits プロパティの値により決定されます。

コンストラクターです。

この軸によって生成される小さな目盛りの配列に対する位置の配列を構築します。 サブクラスでこの関数を実装する必要があります。この関数は、NumericAxis によって自動的に呼び出されます。 この関数を直接呼び出すのではなく、minorTicks プロパティにアクセスする必要があります。

任意のタイプの値のセットにフィルターをかけ、マップできる数字のセットにします。

パラメーター

軸が日を基準にした labelUnits でレンダリングされるときに使用されるデフォルトのフォーマット関数です。 カスタム DateTimeAxis クラスを作成する場合は、このメソッドをオーバーライドして代替のデフォルト書式を提供することができます。

このメソッドは直接呼び出さないでください。 代わりに、このメソッドが呼び出された後、ラベルがレンダリングされ、表示する適切なストリングが取得されます。

パラメーター

軸がミリ秒を基準にした labelUnits でレンダリングされるときに使用されるデフォルトのフォーマット関数です。 カスタム DateTimeAxis クラスを作成する場合は、このメソッドをオーバーライドして代替のデフォルト書式を提供することができます。

このメソッドは直接呼び出さないでください。 代わりに、このメソッドが呼び出された後、ラベルがレンダリングされ、表示する適切なストリングが取得されます。

パラメーター

軸が分を基準にした labelUnits でレンダリングされるときに使用されるデフォルトのフォーマット関数です。 カスタム DateTimeAxis クラスを作成する場合は、このメソッドをオーバーライドして代替のデフォルト書式を提供することができます。

このメソッドは直接呼び出さないでください。 代わりに、このメソッドが呼び出された後、ラベルがレンダリングされ、表示する適切なストリングが取得されます。

パラメーター

軸が月を基準にした labelUnits でレンダリングされるときに使用されるデフォルトのフォーマット関数です。 カスタム DateTimeAxis クラスを作成する場合は、このメソッドをオーバーライドして代替のデフォルト書式を提供することができます。

このメソッドは直接呼び出さないでください。 代わりに、このメソッドが呼び出された後、ラベルがレンダリングされ、表示する適切なストリングが取得されます。

パラメーター

軸が秒を基準にした labelUnits でレンダリングされるときに使用されるデフォルトのフォーマット関数です。 カスタム DateTimeAxis クラスを作成する場合は、このメソッドをオーバーライドして代替のデフォルト書式を提供することができます。

このメソッドは直接呼び出さないでください。 代わりに、このメソッドが呼び出された後、ラベルがレンダリングされ、表示する適切なストリングが取得されます。

パラメーター

軸が年を基準にした labelUnits でレンダリングされるときに使用されるデフォルトのフォーマット関数です。 カスタム DateTimeAxis クラスを作成する場合は、このメソッドをオーバーライドして代替のデフォルト書式を提供することができます。

このメソッドは直接呼び出さないでください。 代わりに、このメソッドが呼び出された後、ラベルがレンダリングされ、表示する適切なストリングが取得されます。

パラメーター

AxisRenderer がラベルを重ならないようにレンダリングできず、Axis オブジェクトによりラベルのセットが減らされるようにする場合に起動されます。 重なった 2 つのラベルがメソッドに渡されます。

パラメーター

値のセットをデータ領域からスクリーン領域にマップします。

パラメーター