CoreUI PRO for React.js
This Component is a part of CoreUI PRO for React.js, an advanced UI library offering over 100 components designed for creating responsive, sleek, and powerful applications. Experience it yourself by signing up for a complimentary 7-day trial.

React Date Range Picker Component

Date Range Picker

The React Date Range Picker component by CoreUI is a versatile tool for selecting date ranges. It is designed for compatibility across various browsers and devices, making it a reliable choice for diverse applications.

Other frameworks

CoreUI components are available as native Angular, Bootstrap (Vanilla JS), and Vue components. To learn more please visit the following pages.

Example#

Explore basic usage of the Date Range Picker through sample code snippets that demonstrate its core functionality.

Days#

Select date ranges by day with examples including basic usage, as well as variants featuring time pickers and footers for enhanced functionality.

<div className="row">
<div className="col-sm-6 mb-3 mb-sm-0">
<CDateRangePicker
label="Date range"
locale="en-US"
onStartDateChange={(date) => console.log(date)}
onEndDateChange={(date) => console.log(date)}
/>
</div>
<div className="col-sm-6">
<CDateRangePicker
endDate="2022/08/17"
label="Date range"
locale="en-US"
startDate="2022/08/03"
/>
</div>
</div>

With timepicker#

Our React DateRangePicker component not only supports date selection but also includes a time picker feature for selecting a specific time of day. Enable the React TimePicker by passing a timepicker prop to the <CDatePicker/> component.

::
::
::
::
<CDateRangePicker locale="en-US" timepicker />
<CDateRangePicker
startDate="2022/08/03 02:34:17 AM"
endDate="2022/09/17 11:29:41 PM"
locale="en-US"
timepicker
/>

Here's an example with an additional footer. The footer is useful for displaying extra information or actions related to the selected date, such as "Today" or "Clear" buttons. The footer component is fully customizable and can be styled to match the rest of the application.

<CDateRangePicker footer locale="en-US" />
<CDateRangePicker startDate="2022/08/03" endDate="2022/08/17" footer locale="en-US" />

Weeks#

To enable week selection, set the selectionType property to week and pass the showWeekNumber prop to display week numbers.

<div className="row">
<div className="col-sm-6 mb-3 mb-sm-0">
<CDateRangePicker
label="Date range"
locale="en-US"
selectionType="week"
showWeekNumber
onStartDateChange={(date) => console.log(date)}
onEndDateChange={(date) => console.log(date)}
/>
</div>
<div className="col-sm-6">
<CDateRangePicker
startDate="2025W07"
endDate="2025W12"
label="Date range"
locale="en-US"
selectionType="week"
showWeekNumber
onStartDateChange={(date) => console.log(date)}
onEndDateChange={(date) => console.log(date)}
/>
</div>
</div>

Months#

Set the selectionType property to month to enable months range selection.

<div className="row">
<div className="col-sm-6 mb-3 mb-sm-0">
<CDateRangePicker
label="Date range"
locale="en-US"
selectionType="month"
onStartDateChange={(date) => console.log(date)}
onEndDateChange={(date) => console.log(date)}
/>
</div>
<div className="col-sm-6">
<CDateRangePicker
label="Date range"
locale="en-US"
selectionType="month"
startDate="2022-8"
endDate="2023-5"
onStartDateChange={(date) => console.log(date)}
onEndDateChange={(date) => console.log(date)}
/>
</div>
</div>

Years#

Set the selectionType property to year to enable years range selection.

<div className="row">
<div className="col-sm-6 mb-3 mb-sm-0">
<CDateRangePicker
label="Date range"
locale="en-US"
selectionType="year"
onStartDateChange={(date) => console.log(date)}
onEndDateChange={(date) => console.log(date)}
/>
</div>
<div className="col-sm-6">
<CDateRangePicker
label="Date range"
locale="en-US"
selectionType="year"
startDate="2022"
endDate="2028"
onStartDateChange={(date) => console.log(date)}
onEndDateChange={(date) => console.log(date)}
/>
</div>
</div>

Sizing#

Set heights using size property like size="lg" and size="sm".

<CDateRangePicker locale="en-US" size="lg" />
<CDateRangePicker locale="en-US" size="sm" />

Disabled#

Add the disabled boolean attribute on an input to give it a grayed out appearance and remove pointer events.

<CDateRangePicker disabled locale="en-US" />

Readonly#

Add the inputReadOnly boolean attribute to prevent modification of the input's value.

<CDateRangePicker inputReadOnly locale="en-US" />

Disabled dates#

Our React Date Range Picker component features the ability to disable specific dates, such as weekends or holidays, by using the disabledDate prop. This prop takes an array and uses custom logic to determine which dates should be disabled.

const calendarDate = new Date(2022, 2, 1)
const disabledDates = [
[new Date(2022, 2, 4), new Date(2022, 2, 7)], // range of dates that cannot be selected
new Date(2022, 2, 16), // single date that cannot be selected
new Date(2022, 3, 16), // single date that cannot be selected
[new Date(2022, 4, 2), new Date(2022, 4, 8)], // range of dates that cannot be selected
]
const maxDate = new Date(2022, 5, 0)
const minDate = new Date(2022, 1, 1)
return (
<div className="row">
<div className="col-lg-5">
<CDateRangePicker
calendarDate={calendarDate}
disabledDates={disabledDates}
locale="en-US"
maxDate={maxDate}
minDate={minDate}
/>
</div>
</div>
)

Custom ranges#

In order to configure custom date ranges in the Date Range component, you must use the ranges prop to define a set of predefined ranges. These ranges can include predefined options such as "Today", "Yesterday", "Last 7 Days", etc.

const customRanges = {
Today: [new Date(), new Date()],
Yesterday: [
new Date(new Date().setDate(new Date().getDate() - 1)),
new Date(new Date().setDate(new Date().getDate() - 1)),
],
'Last 7 Days': [new Date(new Date().setDate(new Date().getDate() - 6)), new Date(new Date())],
'Last 30 Days': [new Date(new Date().setDate(new Date().getDate() - 29)), new Date(new Date())],
'This Month': [
new Date(new Date().setDate(1)),
new Date(new Date().getFullYear(), new Date().getMonth() + 1, 0),
],
'Last Month': [
new Date(new Date().getFullYear(), new Date().getMonth() - 1, 1),
new Date(new Date().getFullYear(), new Date().getMonth(), 0),
],
}
return (
<div className="row">
<div className="col-lg-5">
<CDateRangePicker ranges={customRanges} />
</div>
</div>
)

Non-english locale#

CoreUI's React Date Range Picker enables the display of dates and times in non-English locales, making it essential for international users and multilingual support.

Auto#

By default, the DateRangePicker component uses the default browser locale, but it can be easily configured to use a different locale supported by the JavaScript Internationalization API. To set the locale, you can pass the desired language code as a prop to the DateRangePicker component. This feature enables the creation of more inclusive and accessible applications that cater to a diverse audience.

<CDateRangePicker />

Chinese#

Here is an example of a simple React Date Range Picker with Chinese localization.

<CDateRangePicker locale="zh-CN" placeholder={['入住日期', '退房日期']} />

Japanese#

Below is an example of a basic React Date Range Picker with Japanese locales.

<CDateRangePicker locale="ja" placeholder={['日付を選択', '終了日']} />

Korean#

Here's a simple example of a Date Range Picker with Korean locales.

<CDateRangePicker locale="ko" placeholder={['날짜 선택', '종료일']} />

Right to left support#

RTL support is built-in and can be explicitly controlled through the $enable-rtl variables in scss.

Hebrew#

<CDateRangePicker placeholder={['בחר תאריך', 'תאריך סיום']} locale="he-IL" />

Persian#

<CDateRangePicker locale="fa-IR" placeholder={['تاریخ شروع', 'تاریخ پایان']} />

Custom formats#

Heads up! As of v5.0.0, the format property is removed in <CDateRangePicker>. Instead, utilize the inputDateFormat to format dates into custom strings and inputDateParse to parse custom strings into Date objects.

The provided code demonstrates how to use the inputDateFormat and inputDateParse properties. In this example, the format and parse functions from date-fns are employed to tailor the date presentation and interpretation.

import { format, parse } from 'date-fns'
import { es } from 'date-fns/locale'

The inputDateFormat property formats the date into a custom string, while the inputDateParse property parses a custom string into a Date object. The code showcases the date range in different formats based on locale, such as 'MMMM dd, yyyy' and 'yyyy MMMM dd', and accommodates different locales, like 'en-US' and 'es-ES'.

<div className="row">
<div className="col-lg-6">
<CDateRangePicker
startDate="2022/08/03"
endDate="2022/08/17"
label="Date range"
locale="en-US"
inputDateParse={(date) => parse(date, 'MMMM dd, yyyy', new Date())}
inputDateFormat={(date) => format(new Date(date), 'MMMM dd, yyyy')}
/>
</div>
<div className="col-lg-6">
<CDateRangePicker
startDate="2022/08/03"
endDate="2022/08/17"
label="Rango de fechas"
locale="es-ES"
placeholder={['Fecha de inicio', 'Fecha de fin']}
inputDateParse={(date) => parse(date, 'yyyy MMMM dd', new Date(), { locale: es })}
inputDateFormat={(date) => format(new Date(date), 'yyyy MMMM dd', { locale: es })}
/>
</div>
</div>

With timepicker#

If you need to display custom date and time formats, use the timepicker property along with inputDateParse and inputDateFormat. This example shows how you can customize both the date and time formats, allowing users to select a range with time specified, such as 'MMM dd, yyyy h:mm:ss a'.

::
::
::
::
<div className="row">
<div className="col-lg-8 mb-3">
<CDateRangePicker
startDate="2022/08/03 02:34:17 AM"
endDate="2022/09/17 11:29:41 PM"
label="Date range"
locale="en-US"
timepicker
inputDateParse={(date) => parse(date, 'MMM dd, yyyy h:mm:ss a', new Date())}
inputDateFormat={(date) => format(new Date(date), 'MMM dd, yyyy h:mm:ss a')}
/>
</div>
<div className="col-lg-8">
<CDateRangePicker
startDate="2022/08/03 02:34:17 AM"
endDate="2022/09/17 11:29:41 PM"
label="Rango de fechas"
locale="es-ES"
placeholder={['Fecha de inicio', 'Fecha de fin']}
timepicker
inputDateParse={(date) => parse(date, 'yyyy MMM dd h:mm:ss a', new Date(), { locale: es })}
inputDateFormat={(date) => format(new Date(date), 'yyyy MMM dd h:mm:ss a', { locale: es })}
/>
</div>
</div>

Weeks#

If you want to show weeks in a custom format, set the selectionType to 'week'. This example demonstrates how to use inputDateParse and inputDateFormat to present and parse week-based date strings, like 'wo yyyy'. Including the showWeekNumber property allows you to display week numbers, which can be formatted according to your needs.

<div className="row">
<div className="col-lg-6">
<CDateRangePicker
startDate="2022W10"
endDate="2022W13"
label="Date range"
locale="en-US"
inputDateParse={(date) => parse(date, 'wo YYYY', new Date(), {
useAdditionalWeekYearTokens: true,
})}
inputDateFormat={(date) => format(new Date(date), 'wo yyyy')}
selectionType="week"
showWeekNumber
/>
</div>
<div className="col-lg-6">
<CDateRangePicker
startDate="2022W10"
endDate="2022W13"
label="Rango de fechas"
locale="es-ES"
inputDateParse={(date) => parse(date, 'wo YYYY', new Date(), {
locale: es,
useAdditionalWeekYearTokens: true,
})}
inputDateFormat={(date) => format(new Date(date), 'wo yyyy', { locale: es })}
selectionType="week"
showWeekNumber
/>
</div>
</div>

Months#

If your application requires month selection in a specific format, use the selectionType set to 'month'. This example shows how to customize the month display using inputDateFormat and how to parse month strings with inputDateParse, allowing for formats such as 'MMM yyyy'.

<div className="row">
<div className="col-lg-6">
<CDateRangePicker
startDate="2022-08"
endDate="2023-04"
label="Date range"
locale="en-US"
inputDateParse={(date) => parse(date, 'MMM yyyy', new Date())}
inputDateFormat={(date) => format(new Date(date), 'MMM yyyy')}
selectionType="month"
/>
</div>
<div className="col-lg-6">
<CDateRangePicker
startDate="2022-08"
endDate="2023-04"
label="Rango de fechas"
locale="es-ES"
inputDateParse={(date) => parse(date, 'MMM yyyy', new Date(), { locale: es })}
inputDateFormat={(date) => format(new Date(date), 'MMM yyyy', { locale: es })}
selectionType="month"
/>
</div>
</div>

Years#

If you need to format years in a custom way, use the selectionType set to 'year'. This example provides guidance on using inputDateFormat and inputDateParse to work with custom year formats like 'yy'.

<div className="row">
<div className="col-lg-6">
<CDateRangePicker
startDate="2022"
endDate="2024"
label="Date range"
locale="en-US"
inputDateParse={(date) => parse(date, 'yy', new Date())}
inputDateFormat={(date) => format(new Date(date), 'yy')}
selectionType="year"
/>
</div>
<div className="col-lg-6">
<CDateRangePicker
startDate="2022"
endDate="2024"
label="Rango de fechas"
locale="es-ES"
inputDateParse={(date) => parse(date, 'yy', new Date(), { locale: es })}
inputDateFormat={(date) => format(new Date(date), 'yy', { locale: es })}
selectionType="year"
/>
</div>
</div>

Customizing#

CSS variables#

React date range pickers use local CSS variables on .date-picker and .calendar for enhanced real-time customization. Values for the CSS variables are set via Sass, so Sass customization is still supported, too.

--cui-date-picker-zindex: #{$date-picker-zindex};
--cui-date-picker-font-family: #{$date-picker-font-family};
--cui-date-picker-font-size: #{$date-picker-font-size};
--cui-date-picker-font-weight: #{$date-picker-font-weight};
--cui-date-picker-line-height: #{$date-picker-line-height};
--cui-date-picker-color: #{$date-picker-color};
--cui-date-picker-bg: #{$date-picker-bg};
--cui-date-picker-box-shadow: #{$date-picker-box-shadow};
--cui-date-picker-border-width: #{$date-picker-border-width};
--cui-date-picker-border-color: #{$date-picker-border-color};
--cui-date-picker-border-radius: #{$date-picker-border-radius};
--cui-date-picker-disabled-color: #{$date-picker-disabled-color};
--cui-date-picker-disabled-bg: #{$date-picker-disabled-bg};
--cui-date-picker-disabled-border-color: #{$date-picker-disabled-border-color};
--cui-date-picker-focus-color: #{$date-picker-focus-color};
--cui-date-picker-focus-bg: #{$date-picker-focus-bg};
--cui-date-picker-focus-border-color: #{$date-picker-focus-border-color};
--cui-date-picker-focus-box-shadow: #{$date-picker-focus-box-shadow};
--cui-date-picker-placeholder-color: #{$date-picker-placeholder-color};
--cui-date-picker-padding-y: #{$date-picker-padding-y};
--cui-date-picker-padding-x: #{$date-picker-padding-x};
--cui-date-picker-indicator-icon: #{escape-svg($date-picker-indicator-icon)};
--cui-date-picker-indicator-icon-color: #{$date-picker-indicator-icon-color};
--cui-date-picker-indicator-icon-size: #{$date-picker-indicator-icon-size};
--cui-date-picker-cleaner-icon: #{escape-svg($date-picker-cleaner-icon)};
--cui-date-picker-cleaner-icon-color: #{$date-picker-cleaner-icon-color};
--cui-date-picker-cleaner-icon-hover-color: #{$date-picker-cleaner-icon-hover-color};
--cui-date-picker-cleaner-icon-size: #{$date-picker-cleaner-icon-size};
--cui-date-picker-separator-icon: #{escape-svg($date-picker-separator-icon)};
--cui-date-picker-separator-icon-rtl: #{escape-svg($date-picker-separator-icon-rtl)};
--cui-date-picker-separator-icon-size: #{$date-picker-separator-icon-size};
--cui-date-picker-dropdown-bg: #{$date-picker-dropdown-bg};
--cui-date-picker-dropdown-border-width: #{$date-picker-dropdown-border-width};
--cui-date-picker-dropdown-border-color: #{$date-picker-dropdown-border-color};
--cui-date-picker-dropdown-border-radius: #{$date-picker-dropdown-border-radius};
--cui-date-picker-dropdown-box-shadow: #{$date-picker-dropdown-box-shadow};
--cui-date-picker-ranges-width: #{$date-picker-ranges-width};
--cui-date-picker-ranges-padding: #{$date-picker-ranges-padding};
--cui-date-picker-ranges-border-width: #{$date-picker-ranges-border-width};
--cui-date-picker-ranges-border-color: #{$date-picker-ranges-border-color};
--cui-date-picker-timepicker-width: #{$date-picker-timepicker-width};
--cui-date-picker-timepicker-border-color: #{$date-picker-timepicker-border-color};
--cui-date-picker-timepicker-border-top: #{$date-picker-timepicker-border-width} solid var(--cui-date-picker-timepicker-border-color);
--cui-date-picker-footer-padding: #{$date-picker-footer-padding};
--cui-date-picker-footer-border-width: #{$date-picker-footer-border-width};
--cui-date-picker-footer-border-color: #{$date-picker-footer-border-color};
--cui-calendar-table-margin: #{$calendar-table-margin};
--cui-calendar-table-cell-size: #{$calendar-table-cell-size};
--cui-calendar-nav-padding: #{$calendar-nav-padding};
--cui-calendar-nav-border-color: #{$calendar-nav-border-color};
--cui-calendar-nav-border: #{$calendar-nav-border-width} solid var(--cui-calendar-nav-border-color);
--cui-calendar-nav-date-color: #{$calendar-nav-date-color};
--cui-calendar-nav-date-hover-color: #{$calendar-nav-date-hover-color};
--cui-calendar-nav-icon-width: #{$calendar-nav-icon-width};
--cui-calendar-nav-icon-height: #{$calendar-nav-icon-height};
--cui-calendar-nav-icon-double-next: #{escape-svg($calendar-nav-icon-double-next)};
--cui-calendar-nav-icon-double-prev: #{escape-svg($calendar-nav-icon-double-prev)};
--cui-calendar-nav-icon-next: #{escape-svg($calendar-nav-icon-next)};
--cui-calendar-nav-icon-prev: #{escape-svg($calendar-nav-icon-prev)};
--cui-calendar-nav-icon-color: #{$calendar-nav-icon-color};
--cui-calendar-nav-icon-hover-color: #{$calendar-nav-icon-hover-color};
--cui-calendar-cell-header-inner-color: #{$calendar-cell-header-inner-color};
--cui-calendar-cell-week-number-color: #{$calendar-cell-week-number-color};
--cui-calendar-cell-hover-color: #{$calendar-cell-hover-color};
--cui-calendar-cell-hover-bg: #{$calendar-cell-hover-bg};
--cui-calendar-cell-focus-box-shadow: #{$calendar-cell-focus-box-shadow};
--cui-calendar-cell-disabled-color: #{$calendar-cell-disabled-color};
--cui-calendar-cell-selected-color: #{$calendar-cell-selected-color};
--cui-calendar-cell-selected-bg: #{$calendar-cell-selected-bg};
--cui-calendar-cell-range-bg: #{$calendar-cell-range-bg};
--cui-calendar-cell-range-hover-bg: #{$calendar-cell-range-hover-bg};
--cui-calendar-cell-range-hover-border-color: #{$calendar-cell-range-hover-border-color};
--cui-calendar-cell-today-color: #{$calendar-cell-today-color};
--cui-calendar-cell-week-number-color: #{$calendar-cell-week-number-color};

How to use CSS variables#

const vars = {
'--my-css-var': 10,
'--my-another-css-var': 'red',
}
return <CDateRangePicker style={vars}>...</CDateRangePicker>

SASS variables#

$date-picker-zindex: 1000 !default;
$date-picker-font-family: $input-font-family !default;
$date-picker-font-size: $input-font-size !default;
$date-picker-font-weight: $input-font-weight !default;
$date-picker-line-height: $input-line-height !default;
$date-picker-color: $input-color !default;
$date-picker-bg: $input-bg !default;
$date-picker-box-shadow: $box-shadow-inset !default;
$date-picker-border-width: $input-border-width !default;
$date-picker-border-color: $input-border-color !default;
$date-picker-border-radius: $border-radius !default;
$date-picker-border-radius-sm: $border-radius-sm !default;
$date-picker-border-radius-lg: $border-radius-lg !default;
$date-picker-invalid-border-color: var(--cui-form-invalid-border-color) !default;
$date-picker-valid-border-color: var(--cui-form-valid-border-color) !default;
$date-picker-disabled-color: $input-disabled-color !default;
$date-picker-disabled-bg: $input-disabled-bg !default;
$date-picker-disabled-border-color: $input-disabled-border-color !default;
$date-picker-focus-color: $input-focus-color !default;
$date-picker-focus-bg: $input-focus-bg !default;
$date-picker-focus-border-color: $input-focus-border-color !default;
$date-picker-focus-box-shadow: $input-btn-focus-box-shadow !default;
$date-picker-placeholder-color: var(--cui-secondary-color) !default;
$date-picker-padding-y: $input-padding-y !default;
$date-picker-padding-x: $input-padding-x !default;
$date-picker-padding-y-sm: $input-padding-y-sm !default;
$date-picker-padding-x-sm: $input-padding-x-sm !default;
$date-picker-padding-y-lg: $input-padding-y-lg !default;
$date-picker-padding-x-lg: $input-padding-x-lg !default;
$date-picker-cleaner-icon-color: var(--cui-tertiary-color) !default;
$date-picker-cleaner-icon: url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 512 512' role='img'><polygon fill='#000' points='306.912 214.461 256 265.373 205.088 214.461 182.461 237.088 233.373 288 182.461 338.912 205.088 361.539 256 310.627 306.912 361.539 329.539 338.912 278.627 288 329.539 237.088 306.912 214.461'></polygon><path fill='#000' d='M472,96H384V40H352V96H160V40H128V96H40a24.028,24.028,0,0,0-24,24V456a24.028,24.028,0,0,0,24,24H472a24.028,24.028,0,0,0,24-24V120A24.028,24.028,0,0,0,472,96Zm-8,352H48V128h80v40h32V128H352v40h32V128h80Z'></path></svg>") !default;
$date-picker-cleaner-icon-hover-color: var(--cui-body-color) !default;
$date-picker-cleaner-icon-size: 1rem !default;
$date-picker-cleaner-icon-size-sm: .875rem !default;
$date-picker-cleaner-icon-size-lg: 1.25rem !default;
$date-picker-indicator-icon-color: var(--cui-tertiary-color) !default;
$date-picker-indicator-icon: url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 512 512' role='img'><path fill='#000' d='M472,96H384V40H352V96H160V40H128V96H40a24.028,24.028,0,0,0-24,24V456a24.028,24.028,0,0,0,24,24H472a24.028,24.028,0,0,0,24-24V120A24.028,24.028,0,0,0,472,96Zm-8,352H48V128h80v40h32V128H352v40h32V128h80Z'></path><rect width='32' height='32' x='112' y='224' fill='#000'></rect><rect width='32' height='32' x='200' y='224' fill='#000'></rect><rect width='32' height='32' x='280' y='224' fill='#000'></rect><rect width='32' height='32' x='368' y='224' fill='#000'></rect><rect width='32' height='32' x='112' y='296' fill='#000'></rect><rect width='32' height='32' x='200' y='296' fill='#000'></rect><rect width='32' height='32' x='280' y='296' fill='#000'></rect><rect width='32' height='32' x='368' y='296' fill='#000'></rect><rect width='32' height='32' x='112' y='368' fill='#000'></rect><rect width='32' height='32' x='200' y='368' fill='#000'></rect><rect width='32' height='32' x='280' y='368' fill='#000'></rect><rect width='32' height='32' x='368' y='368' fill='#000'></rect></svg>") !default;
$date-picker-indicator-invalid-icon: $date-picker-indicator-icon !default;
$date-picker-indicator-invalid-icon-color: var(--cui-form-invalid-color) !default;
$date-picker-indicator-valid-icon: $date-picker-indicator-icon !default;
$date-picker-indicator-valid-icon-color: var(--cui-form-valid-color) !default;
$date-picker-indicator-icon-size: 1rem !default;
$date-picker-indicator-icon-size-sm: .875rem !default;
$date-picker-indicator-icon-size-lg: 1.25rem !default;
$date-picker-separator-icon-color: var(--cui-tertiary-color) !default;
$date-picker-separator-icon: url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 512 512' role='img'><polygon fill='#000' points='359.873 121.377 337.246 144.004 433.243 240.001 16 240.001 16 240.002 16 272.001 16 272.002 433.24 272.002 337.246 367.996 359.873 390.623 494.498 256 359.873 121.377'></polygon></svg>") !default;
$date-picker-separator-icon-rtl: url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 512 512' role='img'><polygon fill='#000' points='497.333 239.999 80.092 239.999 176.087 144.004 153.46 121.377 18.837 256 153.46 390.623 176.087 367.996 80.09 271.999 497.333 271.999 497.333 239.999'></polygon></svg>") !default;
$date-picker-separator-icon-size: 1rem !default;
$date-picker-separator-icon-size-sm: .875rem !default;
$date-picker-separator-icon-size-lg: 1.25rem !default;
$date-picker-dropdown-bg: var(--cui-body-bg) !default;
$date-picker-dropdown-border-color: var(--cui-border-color) !default;
$date-picker-dropdown-border-width: var(--cui-border-width) !default;
$date-picker-dropdown-border-radius: var(--cui-border-radius) !default;
$date-picker-dropdown-box-shadow: var(--cui-box-shadow) !default;
$date-picker-ranges-width: 10rem !default;
$date-picker-ranges-padding: $spacer * .5 !default;
$date-picker-ranges-border-width: 1px !default;
$date-picker-ranges-border-color: var(--cui-border-color) !default;
$date-picker-timepicker-width: (7 * $calendar-table-cell-size) + (2 * $calendar-table-margin) !default;
$date-picker-timepicker-border-width: 1px !default;
$date-picker-timepicker-border-color: var(--cui-border-color) !default;
$date-picker-footer-padding: .5rem !default;
$date-picker-footer-border-width: 1px !default;
$date-picker-footer-border-color: var(--cui-border-color) !default;
$calendar-table-margin: .5rem !default;
$calendar-table-cell-size: 2.75rem !default;
$calendar-nav-padding: .5rem !default;
$calendar-nav-border-width: 1px !default;
$calendar-nav-border-color: var(--cui-border-color) !default;
$calendar-nav-date-color: var(--cui-body-color) !default;
$calendar-nav-date-hover-color: var(--cui-primary) !default;
$calendar-nav-icon-width: 1rem !default;
$calendar-nav-icon-height: 1rem !default;
$calendar-nav-icon-color: var(--cui-tertiary-color) !default;
$calendar-nav-icon-hover-color: var(--cui-body-color) !default;
$calendar-nav-icon-double-next: url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 512 512' role='img'><polygon fill='#000' points='95.314 447.313 72.686 424.687 245.373 252 72.686 79.313 95.314 56.687 290.627 252 95.314 447.313'></polygon><polygon fill='#000' points='255.314 447.313 232.686 424.687 405.373 252 232.686 79.313 255.314 56.687 450.627 252 255.314 447.313'></polygon></svg>") !default;
$calendar-nav-icon-double-prev: url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 512 512' role='img'><polygon fill='#000' points='416.686 447.313 221.373 252 416.686 56.687 439.314 79.313 266.627 252 439.314 424.687 416.686 447.313'></polygon><polygon fill='#000' points='256.686 447.313 61.373 252 256.686 56.687 279.314 79.313 106.627 252 279.314 424.687 256.686 447.313'></polygon></svg>") !default;
$calendar-nav-icon-next: url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 512 512' role='img'><polygon fill='#000' points='179.313 451.313 156.687 428.687 329.372 256 156.687 83.313 179.313 60.687 374.627 256 179.313 451.313'></polygon></svg>") !default;
$calendar-nav-icon-prev: url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 512 512' role='img'><polygon fill='#000' points='324.687 451.313 129.373 256 324.687 60.687 347.313 83.313 174.628 256 347.313 428.687 324.687 451.313'></polygon></svg>") !default;
$calendar-cell-header-inner-color: var(--cui-secondary-color) !default;
$calendar-cell-week-number-color: var(--cui-secondary-color) !default;
$calendar-cell-hover-color: var(--cui-body-color) !default;
$calendar-cell-hover-bg: var(--cui-tertiary-bg) !default;
$calendar-cell-disabled-color: var(--cui-tertiary-color) !default;
$calendar-cell-focus-box-shadow: $focus-ring-box-shadow !default;
$calendar-cell-selected-color: $white !default;
$calendar-cell-selected-bg: var(--cui-primary) !default;
$calendar-cell-range-bg: rgba(var(--cui-primary-rgb), .125) !default;
$calendar-cell-range-hover-bg: rgba(var(--cui-primary-rgb), .25) !default;
$calendar-cell-range-hover-border-color: var(--cui-primary) !default;
$calendar-cell-today-color: var(--cui-danger) !default;
$calendar-cell-week-number-color: var(--cui-tertiary-color) !default;

API#

CDateRangePicker#

import { CDateRangePicker } from '@coreui/react-pro'
// or
import CDateRangePicker from '@coreui/react-pro/src/components/date-range-picker/CDateRangePicker'
PropertyDescriptionTypeDefault
ariaNavNextMonthLabel
5.5.0+
A string that provides an accessible label for the button that navigates to the next month in the calendar. This label is read by screen readers to describe the action associated with the button.string-
ariaNavNextYearLabel
5.5.0+
A string that provides an accessible label for the button that navigates to the next year in the calendar. This label is intended for screen readers to help users understand the button's functionality.string-
ariaNavPrevMonthLabel
5.5.0+
A string that provides an accessible label for the button that navigates to the previous month in the calendar. Screen readers will use this label to explain the purpose of the button.string-
ariaNavPrevYearLabel
5.5.0+
A string that provides an accessible label for the button that navigates to the previous year in the calendar. This label helps screen reader users understand the button's function.string-
calendarDateDefault date of the componentstring | Date-
calendarsThe number of calendars that render on desktop devices.number2
cancelButtonToggle visibility or set the content of cancel button.ReactNodeCancel
cancelButtonColorSets the color context of the cancel button to one of CoreUI’s themed colors.'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'dark' | 'light' | stringprimary
cancelButtonSizeSize the cancel button small or large.'sm' | 'lg'sm
cancelButtonVariantSet the cancel button variant to an outlined button or a ghost button.'outline' | 'ghost'ghost
classNameA string of all className you want applied to the component.string-
cleanerToggle visibility or set the content of the cleaner button.booleantrue
closeOnSelect
4.8.0+
If true the dropdown will be immediately closed after submitting the full date.booleantrue
confirmButtonToggle visibility or set the content of confirm button.ReactNodeOK
confirmButtonColorSets the color context of the confirm button to one of CoreUI’s themed colors.'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'dark' | 'light' | stringprimary
confirmButtonSizeSize the confirm button small or large.'sm' | 'lg'sm
confirmButtonVariantSet the confirm button variant to an outlined button or a ghost button.'outline' | 'ghost'-
containerSet container type for the component.'dropdown' | 'inline'-
dayFormat
4.3.0+
Set the format of day name.'numeric' | '2-digit' | ((date: Date) => string | number)'numeric'
disabledToggle the disabled state for the component.boolean-
disabledDatesSpecify the list of dates that cannot be selected.Date[] | Date[][] | (Date | Date[])[]-
dropdownClassNamesA string of all className you want applied to the dropdown menu.string-
endDateInitial selected to date (range).string | Date-
feedback
4.2.0+
Provide valuable, actionable feedback.ReactNode-
feedbackInvalid
4.2.0+
Provide valuable, actionable feedback.ReactNode-
feedbackValid
4.2.0+
Provide valuable, actionable invalid feedback when using standard HTML form validation which applied two CSS pseudo-classes, :invalid and :valid.ReactNode-
firstDayOfWeekSets the day of start week.
- 0 - Sunday,
- 1 - Monday,
- 2 - Tuesday,
- 3 - Wednesday,
- 4 - Thursday,
- 5 - Friday,
- 6 - Saturday,
number1
floatingClassName
4.5.0+
A string of all className you want applied to the floating label wrapper.string-
footerToggle visibility of footer element.boolean-
footerContentAdd custom elements to the footer.ReactNode-
idThe id attribute for the input elements. It can be a single string for both the start and end dates. If a single string is used, the postfix "-start-date" and "-end-date" will be automatically added to make the IDs unique. Alternatively, you can use an array of two strings for start and end dates separately.

[Deprecated since v5.3.0] If the property is a type of string, the name attributes for input elements are generated based on this property until you define name prop ex.:
- {id}-start-date
- {id}-end-date
string | [string, string]-
indicatorToggle visibility or set the content of the input indicator.ReactNodetrue
inputDateFormat
5.0.0+
Custom function to format the selected date into a string according to a custom format.(date: Date) => string-
inputDateParse
5.0.0+
Custom function to parse the input value into a valid Date object.(date: string | Date) => Date-
inputOnChangeDelay
5.0.0+
Defines the delay (in milliseconds) for the input field's onChange event.number750
inputReadOnlyToggle the readonly state for the component.boolean-
invalidSet component validation state to invalid.boolean-
label
4.2.0+
Add a caption for a component.ReactNode-
localeSets the default locale for components. If not set, it is inherited from the browser.stringdefault
maxDateMax selectable date.string | Date-
minDateMin selectable date.string | Date-
name
5.3.0+
The name attribute for the input elements. It can be a single string for both the start and end dates. If a single string is used, the postfix "-start-date" and "-end-date" will be automatically added to make the names unique. Alternatively, you can use an array of two strings for start and end dates separately.

Example for single string: 'date-input'
Result: 'date-input-start-date', 'date-input-end-date'

Example for array: ['start-date-input', 'end-date-input']
Result: 'start-date-input', 'end-date-input'
string | [string, string]-
navNextDoubleIconThe custom next double icon.ReactNode-
navNextIconThe custom next icon.ReactNode-
navPrevDoubleIconThe custom prev double icon.ReactNode-
navPrevIconThe custom prev icon.ReactNode-
navYearFirst
4.3.0+
Reorder year-month navigation, and render year first.boolean-
navigationShow arrows navigation.boolean-
onDateHoverCallback fired when the user hovers over the calendar cell.(date: string | Date) => void-
onEndDateChangeCallback fired when the end date changed.(date: string | Date, formatedDate?: string) => void-
onHideCallback fired when the component requests to be hidden.() => void-
onSelectEndChangeCallback fired when the selection type changed.(value: boolean) => void-
onShowCallback fired when the component requests to be shown.() => void-
onStartDateChangeCallback fired when the start date changed.(date: string | Date, formatedDate?: string) => void-
onViewChangedCallback fired when the view type of calendar changed.(view: string) => void-
placeholderSpecifies short hints that are visible in start date and end date inputs.string | string[]['Start date', 'End date']
rangesPredefined date ranges the user can select from.object-
rangesButtonsColorSets the color context of the cancel button to one of CoreUI’s themed colors.'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'dark' | 'light' | stringsecondary
rangesButtonsSizeSize the ranges button small or large.'sm' | 'lg'-
rangesButtonsVariantSet the ranges button variant to an outlined button or a ghost button.'outline' | 'ghost'ghost
required
4.10.0+
When present, it specifies that date must be filled out before submitting the form.boolean-
selectAdjacementDays
4.11.0+
Set whether days in adjacent months shown before or after the current month are selectable. This only applies if the showAdjacementDays option is set to true.boolean-
selectEndDateToggle select mode between start and end date.boolean-
selectionType
5.0.0+
Specify the type of date selection as day, week, month, or year.'day' | 'week' | 'month' | 'year'day
separatorDefault icon or character character that separates two dates.ReactNodetrue
showAdjacementDays
4.11.0+
Set whether to display dates in adjacent months (non-selectable) at the start and end of the current month.boolean-
showWeekNumber
5.0.0+
Set whether to display week numbers in the calendar.boolean-
sizeSize the component small or large.'sm' | 'lg'-
startDateInitial selected date.string | Date-
text
4.2.0+
Add helper text to the component.ReactNode-
timepickerProvide an additional time selection by adding select boxes to choose times.boolean-
todayButtonToggle visibility or set the content of today button.ReactNodeToday
todayButtonColorSets the color context of the today button to one of CoreUI’s themed colors.'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'dark' | 'light' | stringprimary
todayButtonSizeSize the today button small or large.'sm' | 'lg'sm
todayButtonVariantSet the today button variant to an outlined button or a ghost button.'outline' | 'ghost'-
togglerThe content of toggler.ReactNode-
tooltipFeedback
4.2.0+
Display validation feedback in a styled tooltip.boolean-
validSet component validation state to valid.boolean-
visibleToggle the visibility of dropdown menu component.boolean-
weekNumbersLabel
5.0.0+
Label displayed over week numbers in the calendar.string-
weekdayFormatSet length or format of day name.number | 'long' | 'narrow' | 'short' | ((date: Date) => string | number)2