DateTimeAxis  - AS3 Flex

Определяет размещение меток на оси.

Если задано значение false, диаграмма всегда помещает метку в начале оси. Например, если метки отображаются на основе месяца, и первой точкой данных является 14 июля, то первая метка соответствует 14 июля. Если задано значение true, сначала вычисляются единицы метки, а затем целиком отмечается первый интервал, соответствующий этим единицам. Например, если первой точкой данных является 14 июля, а в качестве единицы метки определен месяц (задан явно или вычислен динамически), то первой метке соответствует 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 для определения ширины при визуализации столбцов.

Если, например, свойство labelUnits горизонтальной оси элемента управления ColumnChart имеет значение weeks, и свойство dataUnits имеет значение days, ColumnChart отображает каждый столбец в позиции, соответствующей 1/7 расстояния между метками.

Если свойство dataUnits имеет значение null, столбцы колоночных серий отображаются как дни, однако DateTimeAxis выбирает соответствующую единицу при генерации меток.

Значением по умолчанию является null.

Дни недели, подлежащие деактивации. Деактивируются все даты в пределах месяца, соответствующие указанному дню. Элементы этого массива могут иметь значения от 0 (воскресенье) до 6 (суббота). Например, значение [0, 6] деактивирует воскресенье и субботу.

Позволяет деактивировать один или несколько дней.

Это свойство принимает массив объектов в качестве параметра. Каждый объект в этом массиве является либо объектом Date, определяющим один день, подлежащий деактивации; либо объектом, содержащим один или оба свойства rangeStart и rangeEnd, каждое из значений которых представляет собой объект Date. Значение этих свойств указывает границы диапазона дат. Если любое из значений опущено, диапазон рассматривается как неограниченный в соответствующем направлении. Если определено только свойство rangeStart, деактивируются все даты после указанной даты, включая дату rangeStart. Если определено только свойство rangeEnd, деактивируются все даты, предшествующие указанной дате, включая дату rangeEnd. Для деактивации отдельного дня используется отдельный объект Date в массиве, указывающий определенную дату.

Например, требуется деактивировать следующие даты: 11 января 2006 г. в диапазоне от 23 января до 10 февраля 2006 г., а также 1 марта 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)} ]}"

Значением по умолчанию является [].

Если задано значение true, DateTimeAxis рассматривает все значения даты как принадлежащие часовому поясу клиентского компьютера, на котором функционирует приложение. Если задано значение false, все значения указаны по всемирному (гринвичскому) времени.

Указывает количество labelUnits между значениями меток на оси. Числовое значение интервала вычисляется в приложении Flex, если для этого свойства задано значение null.

Значением по умолчанию является 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.

В метод синтаксического анализа передается только один параметр. Этот параметр является значением точки данных, которое указано для серии. Как правило, это строка, представляющая дату в определенном формате. Отмена этого параметра или добавление дополнительных параметров не допускается.

Этот объект Date немедленно преобразуется в числовое значение, таким образом, пользовательские parseFunctions могут многократно использовать один и тот же объект Date, что положительно влияет на производительность. По умолчанию DateTimeAxis использует функциональные возможности синтаксического анализа строки, предоставляемые стандартным методом Date.parse() 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>
      

Поля структуры DescribeData, используемые осью.

Ширина отдельной единицы данных (в пикселях). Тип единицы данных определяется значением свойства dataUnits.

Конструктор.

Формирует массив позиций для массива вспомогательных делений, генерируемых этой осью. Эта функция реализуется подклассами. Вызов этой функции выполняется автоматически классом NumericAxis. Вместо непосредственного вызова этой функции следует использовать свойство minorTicks.

Отфильтровывает набор значений произвольного типа до набора чисел, которые могут быть отображены.

Параметры

Функция форматирования по умолчанию, применяемая в том случае, если ось визуализируется с использованием labelUnits на основе дня. В случае создания пользовательского класса DateTimeAxis при необходимости использования альтернативного форматирования по умолчанию этот метод можно отменить.

Этот метод не вызывается напрямую. Вместо этого Flex выполняет его вызов перед визуализацией метки в целях отображения соответствующей строки.

Параметры

Функция форматирования по умолчанию, применяемая в том случае, если ось визуализируется с использованием labelUnits на основе миллисекунды. В случае создания пользовательского класса DateTimeAxis при необходимости использования альтернативного форматирования по умолчанию этот метод можно отменить.

Этот метод не вызывается напрямую. Вместо этого Flex выполняет его вызов перед визуализацией метки в целях отображения соответствующей строки.

Параметры

Функция форматирования по умолчанию, применяемая в том случае, если ось визуализируется с использованием labelUnits на основе минуты. В случае создания пользовательского класса DateTimeAxis при необходимости использования альтернативного форматирования по умолчанию этот метод можно отменить.

Этот метод не вызывается напрямую. Вместо этого Flex выполняет его вызов перед визуализацией метки в целях отображения соответствующей строки.

Параметры

Функция форматирования по умолчанию, применяемая в том случае, если ось визуализируется с использованием labelUnits на основе месяца. В случае создания пользовательского класса DateTimeAxis при необходимости использования альтернативного форматирования по умолчанию этот метод можно отменить.

Этот метод не вызывается напрямую. Вместо этого Flex выполняет его вызов перед визуализацией метки в целях отображения соответствующей строки.

Параметры

Функция форматирования по умолчанию, применяемая в том случае, если ось визуализируется с использованием labelUnits на основе секунды. В случае создания пользовательского класса DateTimeAxis при необходимости использования альтернативного форматирования по умолчанию этот метод можно отменить.

Этот метод не вызывается напрямую. Вместо этого Flex выполняет его вызов перед визуализацией метки в целях отображения соответствующей строки.

Параметры

Функция форматирования по умолчанию, применяемая в том случае, если ось визуализируется с использованием labelUnits на основе года. В случае создания пользовательского класса DateTimeAxis при необходимости использования альтернативного форматирования по умолчанию этот метод можно отменить.

Этот метод не вызывается напрямую. Вместо этого Flex выполняет его вызов перед визуализацией метки в целях отображения соответствующей строки.

Параметры

Вызывается, если AxisRenderer не может выполнить чистую визуализацию меток без наложения и если требуется сокращение набора меток с помощью объекта Axis. Методу передаются две перекрывающиеся метки.

Параметры

Преобразует набор значений из области данных в область экрана.

Параметры