scale minRange

Specifies the minimum range that can be selected.

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

Use this property to set the minimum range that can be selected. When moving a slider to to a position near the other slider that is closer than the specified minimum range, the marker will display the last possible value that it can be set to, and change the font color to 'red'. You can set the color used to indicate an invalid range by using the invalidRangeColor property of the sliderMarker configuration object.

For a numeric scale, assign a numeric value to this property. If the scale is of the date-time type, assign one of the predefined string values or an object to this property. The object's properties specify the number of days, hours, etc.

You can also set the maximum range that can be selected using the maxRange property.

Show Example:
jQuery

In this example, the minRange option is set to 'week'.

<div id="rangeSelectorContainer" style="height: 160px"></div>
$(function () {
    $("#rangeSelectorContainer").dxRangeSelector({
        scale: {
            startValue: new Date(2012, 2, 4),
            endValue: new Date(2012, 3, 10),
            minRange: 'week'
        }
    });
});

days

Specifies how many days can be selected as a minimum.

Type: Number

This property is used for a date-time scale only.

Show Example:
jQuery

In this example, the minRange option is set to 14 days.

<div id="rangeSelectorContainer" style="height: 160px"></div>
$(function () {
    $("#rangeSelectorContainer").dxRangeSelector({
        scale: {
            startValue: new Date(2012, 2, 5),
            endValue: new Date(2012, 3, 10),
            minRange: { days: 14 }
        },
        selectedRange: {
            startValue: new Date(2012, 2, 5),
            endValue: new Date(2012, 2, 19)
        }
    });
});

hours

Specifies how many hours can be selected as a minimum.

Type: Number

This property is used for a date-time scale.

Show Example:
jQuery

In this example, the minRange option is set 12 hours.

<div id="rangeSelectorContainer" style="height: 160px"></div>
$(function () {
    $("#rangeSelectorContainer").dxRangeSelector({
        scale: {
            startValue: new Date(2012, 2, 5, 12),
            endValue: new Date(2012, 2, 7, 12),
            minRange: { hours: 12 }
        },
        selectedRange: {
            startValue: new Date(2012, 2, 5, 14),
            endValue: new Date(2012, 2, 6, 14)
        }
    });
});

milliseconds

Specifies how many milliseconds can be selected as a minimum.

Type: Number

This property is used for a date-time scale.

Show Example:
jQuery

In this example, the minRange option is set to 10000 milliseconds.

<div id="rangeSelectorContainer" style="height: 160px"></div>
$(function () {
    $("#rangeSelectorContainer").dxRangeSelector({
        scale: {
            startValue: new Date(2012, 2, 5, 12, 30, 30, 0),
            endValue: new Date(2012, 2, 5, 12, 31, 30, 0),
            minRange: { milliseconds: 10000 }
        },
        selectedRange: {
            startValue: new Date(2012, 2, 5, 12, 30, 40, 0),
            endValue: new Date(2012, 2, 5, 12, 31, 0, 0)
        }
    });
});

minutes

Specifies how many minutes can be selected as a minimum.

Type: Number

This property is used for a date-time scale.

Show Example:
jQuery

In this example, the minRange option is set to 10 minutes.

<div id="rangeSelectorContainer" style="height: 160px"></div>
$(function () {
    $("#rangeSelectorContainer").dxRangeSelector({
        scale: {
            startValue: new Date(2012, 2, 5, 12, 30),
            endValue: new Date(2012, 2, 5, 14, 30),
            minRange: { minutes: 10 }
        },
        selectedRange: {
            startValue: new Date(2012, 2, 5, 13, 0),
            endValue: new Date(2012, 2, 5, 13, 10)
        }
    });
});

months

Specifies how many months can be selected as a minimum.

Type: Number

This property is used for a date-time scale.

Show Example:
jQuery

In this example, the minRange option is set to 3 months.

<div id="rangeSelectorContainer" style="height: 160px"></div>
$(function () {
    $("#rangeSelectorContainer").dxRangeSelector({
        scale: {
            startValue: new Date(2012, 0),
            endValue: new Date(2014, 0),
            minRange: { months: 3 }
        },
        sliderMarker: {
            format: 'monthAndYear'
        },
        selectedRange: {
            startValue: new Date(2012, 4),
            endValue: new Date(2012, 8)
        }
    });
});

seconds

Specifies how many seconds can be selected as a minimum.

Type: Number

This property is used for a date-time scale.

Show Example:
jQuery

In this example, the minRange option is set to 30 seconds.

<div id="rangeSelectorContainer" style="height: 160px"></div>
$(function () {
    $("#rangeSelectorContainer").dxRangeSelector({
        scale: {
            startValue: new Date(2012, 2, 5, 12, 30, 0),
            endValue: new Date(2012, 2, 5, 12, 35, 0),
            minRange: { seconds: 30 }
        },
        selectedRange: {
            startValue: new Date(2012, 2, 5, 12, 32, 0),
            endValue: new Date(2012, 2, 5, 12, 32, 30)
        }
    });
});

years

Specifies how many years can be selected as a minimum.

Type: Number

This property is used for a date-time scale.

Show Example:
jQuery

In this example, the minRange option is set to 5 years.

<div id="rangeSelectorContainer" style="height: 160px"></div>
$(function () {
    $("#rangeSelectorContainer").dxRangeSelector({
        scale: {
            startValue: new Date(1990, 0),
            endValue: new Date(2010, 0),
            minRange: { years: 3 }
        },
        sliderMarker: {
            format: 'year'
        },
        selectedRange: {
            startValue: new Date(2004, 0),
            endValue: new Date(2007, 0)
        }
    });
});