CategoryAxis

Type boolean

Default true

When parse dates is on for the category axis, the chart will try to highlight the beginning of the periods, like month, in bold. Set this to false to disable the functionality.

Type Function

specifies a method that returns the value that should be used as categoryValue for current item. If this property is set, the return value of the custom data function takes precedence over categoryField. When a chart calls this method, it passes category value, data item from chart's data provider and reference to categoryAxis: categoryFunction(category, dataItem, categoryAxis); This method can be used both when category axis parses dates and when it doesn't. If axis parses dates, your categoryFunction should return Date object. For example, if you have date strings in your data, you can use this method to convert these strings into Date objects.

Type boolean

Default true

This setting works only when parseDates is set to true and equalSpacing is set to false. In case you set it to false, labels will never be centered between grid lines.

Type array

Default [{
  period:'fff',
  format:'JJ:NN:SS'
}, {
  period:'ss',
  format:'JJ:NN:SS'
}, {
  period:'mm',
  format:'JJ:NN'
}, {
  period:'hh',
  format:'JJ:NN'
}, {
  period:'DD',
  format:'MMM DD'
}, {
  period:'WW',
  format:'MMM DD'
}, {
  period:'MM',
  format:'MMM'
}, {
  period:'YYYY',
  format:'YYYY'
}]

Date formats of different periods. Possible period values: fff - milliseconds, ss - seconds, mm - minutes, hh - hours, DD - days, MM - months, WW - weeks, YYYY - years. Check this page for date formatting strings.

Type boolean

Default false

In case your category axis values are Date objects and parseDates is set to true, the chart will parse dates and will place your data points at irregular intervals. However if you want dates to be parsed (displayed on the axis, baloons, etc), but data points to be placed at equal intervals (omiting dates with no data), set equalSpacing to true.

Type string

Field in data provider which specifies if the category value should always be shown. For example: categoryAxis.forceShowField = "forceShow";

And in data:

{category:"one", forceShow:true, value:100} Note, this works only when parseDates is set to false.

Type string

Default middle

Specifies if a grid line is placed on the center of a cell or on the beginning of a cell. Possible values are: "start" and "middle" This setting doesn't work if parseDates is set to true.

Type Function

You can use this function to format Category axis labels. If this function is set, then it is called with the following parameters passed:

if dates are not parsed:

labelFunction(valueText, serialDataItem, categoryAxis) if dates are parsed:

labelFunction(valueText, date, categoryAxis) Your function should return string which will be displayed on the axis.

Type boolean

Default true

If you set it to false, the start of longer periods won't use a different date format and won't be bold.

Type string

Default DD

Specifies the shortest period of your data. This should be set only if parseDates is set to "true". Possible period values: fff - milliseconds, ss - seconds, mm - minutes, hh - hours, DD - days, MM - months, YYYY - years.

It's also possible to supply a number for increments, i.e. "15mm" which will instruct the chart that your data is supplied in 15 minute increments.

Type boolean

Default false

In case your category axis values are Date objects, set this to true. In this case the chart will parse dates and will place your data points at irregular intervals. If you want dates to be parsed, but data points to be placed at equal intervals, set both parseDates and equalSpacing to true.

Type boolean

Default false

Specifies whether the graph should start on axis or not. In case you display columns, it is recommended to set this to false. If parseDates is set to true, startOnAxis will allways be false, unless equalSpacing is set to true.

Returns Number

returns coordinate of a category. Works only if parseDates is false. If parseDates is true, use dateToCoordinate method.

category - String

Returns date - Date object

Returns Date of the coordinate, in case parseDates is set to true and equalSpacing is set to false.

coordinate - Number

Returns Number

Returns coordinate of the date, in case parseDates is set to true. if parseDates is false, use categoryToCoordinate method.

date - Date object

Returns Number

Returns index of the category which is most close to specified coordinate.

x - coordinate