JavaScript/jQuery Chart - argumentAxis.aggregationInterval

Specifies the length of aggregation intervals in axis units. Applies only to axes of continuous and logarithmic types.

Type:

Number

|

Object

|

String

Default Value: undefined
Accepted Values: 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year'

For data aggregation, the argument axis is divided into intervals. Series points that fall within the same interval get aggregated together. The aggregationInterval option defines the length of each interval.

If the axis displays numbers, assign a number to this option. For example, an aggregationInterval of 100 produces the following intervals: 0 to 100, 100 to 200, 200 to 300, etc. If the axis displays date-time values, set this option to one of the accepted string values. Alternatively, you can set it to an object that contains one of the fields described in this section.

jQuery
JavaScript
$(function() {
    $("#chartContainer").dxChart({
        // ...
        argumentAxis: {
            // Interval of one day
            aggregationInterval: "day",
            // Interval of five days
            aggregationInterval: { days: 5 }
        }
    });
});
Angular
HTML
TypeScript
<dx-chart ... >
    <dxo-argument-axis
        aggregationInterval="day"> <!-- Interval of one day -->
        <dxo-aggregation-interval
            [days]="5">            <!-- Interval of five days -->
        </dxo-aggregation-interval>
    </dxo-argument-axis>
</dx-chart>
import { DxChartModule } from "devextreme-angular";
// ...
export class AppComponent {
    // ...
}
@NgModule({
    imports: [
        // ...
        DxChartModule
    ],
    // ...
})

On a logarithmic axis, intervals are calculated based on powers. For example, if the logarithmBase is 10 and the aggregationInterval is 1, the following intervals are produced: 100 to 101, 101 to 102, 102 to 103, etc. If the aggregationInterval becomes 2, intervals become longer: 100 to 102, 102 to 104, 104 to 106, etc.

When using the widget as an ASP.NET MVC Control, you can specify this option using the VizTimeInterval enum. This enum accepts the same values, but they start with an upper-case letter, for example, "day" becomes Day.

View Demo

See Also

days

Specifies the time interval measured in days. Available only for an axis/scale displaying date-time values.

Type:

Number

hours

Specifies the time interval measured in hours. Available only for an axis/scale displaying date-time values.

Type:

Number

milliseconds

Specifies the time interval measured in milliseconds. Available only for an axis/scale displaying date-time values.

Type:

Number

minutes

Specifies the time interval measured in minutes. Available only for an axis/scale displaying date-time values.

Type:

Number

months

Specifies the time interval measured in months. Available only for an axis/scale displaying date-time values.

Type:

Number

quarters

Specifies the time interval measured in quarters. Available only for an axis/scale displaying date-time values.

Type:

Number

seconds

Specifies the time interval measured in seconds. Available only for an axis/scale displaying date-time values.

Type:

Number

weeks

Specifies the time interval measured in weeks. Available only for an axis/scale displaying date-time values.

Type:

Number

years

Specifies the time interval measured in years. Available only for an axis/scale displaying date-time values.

Type:

Number