New to Kendo UI for Vue? Start a free 30-day trial

Represents the Kendo UI for Vue DateRangePicker component. Use the DateRangePicker to let the user type or select a start date and an end date.

Definition

Package:@progress/kendo-vue-dateinputs

Properties Interface:DateRangePickerProps

Syntax:

vue
<DateRangePicker :default-value="{ start: new Date(2026, 0, 5), end: new Date(2026, 0, 12) }" :format="'dd/MM/yyyy'" />

Properties

When you set allowReverse to true, the DateRangePicker does not check whether the start date is after the end date (see example).

If you set the calendarSettings property, its allowReverse takes precedence.

Default:

false

Sets the id values of the elements that describe the DateRangePicker, similar to the HTML aria-describedby attribute. For example, these elements can contain an error or a hint message.

Sets the id values of the elements that label the DateRangePicker.

Lets you customize or replace the default Calendar of the DateRangePicker.

Sets the additional props that the DateRangePicker passes to the MultiViewCalendar inside it (see example).

Sets whether the popup of the DateRangePicker is open on the first render (see example).

Default:

false

Sets the initial value of the DateRangePicker when you do not set value (see example).

disabled?

boolean

When you set it to true, the DateRangePicker is disabled (see example).

Default:

false

Lets you customize or replace the default end DateInput of the DateRangePicker (see example).

Sets the additional props that the DateRangePicker passes to the end-date DateInput (see example).

fillMode?

string

Configures the fillMode of the DateRangePicker.

The available options are:

  • solid
  • outline
  • flat
  • link
  • null—Does not set a fillMode class.
Default:

solid

Sets the focused date of the DateRangePicker (see example).

format?

string | DateFormatOptions

Sets the date format of the DateInput values (see example).

If you set startDateInputSettings or endDateInputSettings, their format takes precedence.

Default:

'd'

id?

string

Sets the id of the DateRangePicker.

Sets the built-in HTML attributes of the inner focusable input elements. You cannot change the attributes that the component needs to work.

max?

Date

Sets the latest valid date (see example).

min?

Date

Sets the earliest valid date (see example).

onBlur?

(event: any) => void

Fires each time any element of the DateRangePicker loses focus. The event name is blur.

Parameters:eventany

Fires each time the user selects a part of a date range. The event name is change (see example).

onFocus?

(event: any) => void

Fires each time the user focuses any element of the DateRangePicker. The event name is focus.

Parameters:eventany

Lets you customize or replace the default Popup of the DateRangePicker (see example).

Sets the additional props that the DateRangePicker passes to the Popup inside it (see example).

Default:

{}

rounded?

string

Configures the roundness of the DateRangePicker.

The available options are:

  • small
  • medium
  • large
  • circle
  • full
  • null—Does not set a rounded class.
Default:

medium

show?

boolean

Sets whether the DateRangePicker shows the Calendar (see example).

size?

"small" | "medium" | "large"

Configures the size of the DateRangePicker.

The available options are:

  • small
  • medium
  • large
  • null—Does not set a size class.
Default:

medium

Lets you customize or replace the default start DateInput of the DateRangePicker (see example).

Sets the additional props that the DateRangePicker passes to the start-date DateInput (see example).

When you set it to true, the DateRangePicker shows a Swap Value button (see example).

The DateRangePicker shows the swap button only if you also set the allowReverse property to true.

Default:

false

tabIndex?

number

Sets the tabIndex property of the DateRangePicker.

valid?

boolean

Overrides the validity state of the DateRangePicker. If you set valid, the DateRangePicker ignores the required property.

Sets the selected date range of the DateRangePicker (see example).

The value must be an object with start and end properties. Each one is a valid JavaScript Date instance or null.