Skip to main content

TimeSpanScaleOptions.MeasureUnit Property

Gets or sets the detail level for time-span values.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v22.2.dll

NuGet Package: DevExpress.Charts


public TimeSpanMeasureUnit MeasureUnit { get; set; }

Property Value

Type Description

A value that represents the axis detail level.

Available values:

Name Description

Specifies a millisecond as the measurement unit for time-span values.


Specifies a second as the measurement unit for time-span values.


Specifies a minute as the measurement unit for time-span values.


Specifies an hour as the measurement unit for time-span values.


Specifies a day as the measurement unit for time-span values.

Property Paths

You can access this nested property as listed below:

Object Type Path to MeasureUnit
.TimeSpanScaleOptions .MeasureUnit


This property is available when the SeriesBase.ArgumentScaleType or SeriesBase.ValueScaleType property is set to TimeSpan, and the ScaleOptionsBase.ScaleMode property is set to Manual.

TimeSpanScaleOptions.MeasureUnit = Minute TimeSpanScaleOptions.MeasureUnit = Hour


To access TimeSpanScaleOptions, use the AxisBase.TimeSpanScaleOptions property.

To define a time-span measurement unit to which the beginning of a diagram’s gridlines and labels should be aligned, use the TimeSpanScaleOptions.GridAlignment property.


The following example shows how to group minute-by-minute data into data points with a greater measurement unit (“Hour”).

To do this, you can use the following code:

private void Form1_Load(object sender, EventArgs e) {
    XYDiagram diagram = chartControl1.Diagram as XYDiagram;
    if (diagram != null) {
        diagram.AxisX.TimeSpanScaleOptions.ScaleMode = ScaleMode.Manual;
        diagram.AxisX.TimeSpanScaleOptions.MeasureUnit = TimeSpanMeasureUnit.Hour;
        diagram.AxisX.TimeSpanScaleOptions.AggregateFunction = AggregateFunction.Average;
        diagram.AxisX.TimeSpanScaleOptions.GridSpacing = 6;
        diagram.AxisX.TimeSpanScaleOptions.GridAlignment = TimeSpanGridAlignment.Hour;

The example uses the following API members:

Member Description
ScaleOptionsBase.ScaleMode Gets or sets the scale mode for an axis.
TimeSpanScaleOptions.MeasureUnit Gets or sets the detail level for time-span values.
ScaleGridOptionsBase.AggregateFunction Gets or sets the value indicating the aggregate function that should be used to relieve data.
ScaleGridOptionsBase.GridSpacing Gets or sets the interval between grid lines and major tickmarks.
See Also