DateTimeAxis  - AS3 Flex

确定标签在轴上的位置。

如果设置为 false，图表会始终将标签放置在轴的前端。例如，如果您每月放置一次标签，并且第一个数据点为 7 月 14 日，则您的第一个标签将出现在 7 月 14 日。如果设置为 true，Flex 会首先计算标签单位，然后在这些单位的第一个完整间隔处设置标签。例如，如果您的第一个数据点为 7 月 14 日，并且您的标签单位为月（显式设置或动态计算），则第一个标签将出现在 8 月 1 日。

默认值为 true。

指定图表中数据间的间隔（在 dataUnits 中指定）。

例如，如果将 dataUnits 属性设置为 "hours"，并将 dataInterval 属性设置为 4，则图表将假定您的数据每隔三小时发生一次。这将影响到一些系列（例如 ColumnSeries 和 CandlestickSeries）呈示其数据的方式，还会影响标签的自动选择方式。

相关 API 元素

指定您期望用于表示图表中数据的单位。该值可以是下列值之一：

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

此值有两种用途。第一种，当选择合适的标签单位时，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 ]，将禁用星期日和星期六。

禁用一天或多天。

此属性接受对象 Array 作为参数。此数组中的所有对象都是 Date 对象，用于指定要禁用的各个日期；也可以是一个包含 rangeStart 和（或）rangeEnd 属性的对象。这些属性的值描述了日期范围的边界。如果忽略其中任一属性，则认为在该方向上无范围限制。如果仅指定 rangeStart，则将禁用指定日期之后的所有日期（包括 rangeStart 日期）。如果仅指定 rangeEnd，则将禁用指定日期之前的所有日期（包括 rangeEnd 日期）。要禁用单个日期，请使用一个 Date 对象指定 Array 中的某个日期。

以下示例将禁用下列日期：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，Flex 将指定图表中数据的最小值。

默认值为 null。

指定轴标签的最小值。如果设置为 null，Flex 将指定图表中数据的最小值。

默认值为 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 接下来会解释该对象以将其用于 DateTimeAxis。

Flex 只向分析方法传递一个参数。此参数是您为系列指定的数据点的值。通常，它是表示某种日期形式的 String。您无法覆盖此参数，也无法添加其他参数。

此 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 结构字段。

单个数据单位的宽度，以像素为单位。数据单位的类型由 dataUnits 属性的值确定。

构造函数。

为此轴生成的次要刻度线数组构建位置 Array。子类必须实现此函数。NumericAxis 自动调用此函数。应该访问 minorTicks 属性，而不是直接调用此函数。

将任意类型的一组值过滤为可以映射的一组数字。

参数

当轴采用以天为单位的 labelUnits 呈示时，所使用的默认格式设置函数。如果编写了自定义的 DateTimeAxis 类，则可以覆盖此方法，以提供备用的默认格式。

您无需直接调用此方法。Flex 会在呈示标签前调用此方法，以显示适当的 String。

参数

当轴采用以毫秒为单位的 labelUnits 呈示时，所使用的默认格式设置函数。如果编写了自定义的 DateTimeAxis 类，则可以覆盖此方法，以提供备用的默认格式。

您无需直接调用此方法。Flex 会在呈示标签前调用此方法，以显示适当的 String。

参数

当轴采用以分钟为单位的 labelUnits 呈示时，所使用的默认格式设置函数。如果编写了自定义的 DateTimeAxis 类，则可以覆盖此方法，以提供备用的默认格式。

您无需直接调用此方法。Flex 会在呈示标签前调用此方法，以显示适当的 String。

参数

当轴采用以月为单位的 labelUnits 呈示时，所使用的默认格式设置函数。如果编写了自定义的 DateTimeAxis 类，则可以覆盖此方法，以提供备用的默认格式。

您无需直接调用此方法。Flex 会在呈示标签前调用此方法，以显示适当的 String。

参数

当轴采用以秒为单位的 labelUnits 呈示时，所使用的默认格式设置函数。如果编写了自定义的 DateTimeAxis 类，则可以覆盖此方法，以提供备用的默认格式。

您无需直接调用此方法。Flex 会在呈示标签前调用此方法，以显示适当的 String。

参数

当轴采用以年为单位的 labelUnits 呈示时，所使用的默认格式设置函数。如果编写了自定义的 DateTimeAxis 类，则可以覆盖此方法，以提供备用的默认格式。

您无需直接调用此方法。Flex 会在呈示标签前调用此方法，以显示适当的 String。

参数

当在不发生重叠的情况下 AxisRenderer 无法清楚地显示标签时调用，像 Axis 对象减少标签组中标签的数目一样。此方法传递重叠的两个标签。

参数

将一组来自数据空间的值映射到屏幕空间。

参数