The
DateRangeBox
component allows users to select a date range with ease. The component includes input boxes for start/end dates and a drop-down date picker. This demo illustrates how to apply the following DateRangeBox settings:
value
An array where you can specify the selected range (start/end dates). The DateRangeBox also allows you to define start/end dates separately. For this purpose, use the
startDate
and
endDate
properties instead.
displayFormat
Date display format. You can use one of our
predefined formats
or specify a
custom format
as needs dictate. This demo illustrates the latter.
disabled
Specifies whether the DateRangeBox responds to user interaction.
showClearButton
Displays a button that clears DateRangeBox values.
multiView
Switches between our single-month and two-month dropdown calendar.
applyValueMode
Defines whether the selected value is applied instantly or after a user clicks the
Apply
button.
To get started with the DevExtreme DateRangeBox component, refer to the
Getting Started with DateRangeBox
tutorial.
Feel free to share demo-related thoughts here.
If you have technical questions, please
create a support ticket
in the DevExpress Support Center.
Send Feedback
Thank you for the feedback!
<div class="dx-field">
<div class="dx-field-label multiline-label">
<span>Default functionality</span>
<div class="selected-days-wrapper ">
<span>Days selected: </span>
<span>{{ selectedDays }}</span>
<div class="dx-field-value">
<DxDateRangeBox
v-model:value="currentValue"
<div class="dx-field">
<div class="dx-field-label">Custom format</div>
<div class="dx-field-value">
<DxDateRangeBox
:value="initialValue"
display-format="EEEE, MMM dd"
<div class="dx-field">
<div class="dx-field-label">Use buttons to apply selection</div>
<div class="dx-field-value">
<DxDateRangeBox
apply-value-mode="useButtons"
<div class="dx-field">
<div class="dx-field-label">Single-calendar view</div>
<div class="dx-field-value">
<DxDateRangeBox
:multi-view="false"
<div class="dx-field">
<div class="dx-field-label">Calendar only appears on icon click</div>
<div class="dx-field-value">
<DxDateRangeBox
:open-on-field-click="false"
<div class="dx-field">
<div class="dx-field-label">Limit available dates (this month)</div>
<div class="dx-field-value">
<DxDateRangeBox
:min="min"
:max="max"
<div class="dx-field">
<div class="dx-field-label">Disable out of range selection</div>
<div class="dx-field-value">
<DxDateRangeBox
:disable-out-of-range-selection="true"
<div class="dx-field">
<div class="dx-field-label">Clear button</div>
<div class="dx-field-value">
<DxDateRangeBox
:show-clear-button="true"
:value="initialValue"
</template>
<script setup lang="ts">
import { computed, ref } from 'vue';
import DxDateRangeBox from 'devextreme-vue/date-range-box';
const now = new Date();
const msInDay = 1000 * 60 * 60 * 24;
const initialDates = [
new Date(now.getTime() - msInDay * 3),
new Date(now.getTime() + msInDay * 3),
const currentValue = ref(initialDates);
const initialValue = initialDates;
const lastDay = new Date(now.getFullYear(), now.getMonth() + 1, 0).getDate();
const min = new Date(now.setDate(1));
const max = new Date(now.setDate(lastDay));
const selectedDays = computed(() => convertRangeToDays(currentValue.value));
function convertRangeToDays([startDate, endDate]) {
let daysCount = 0;
if (startDate && endDate) {
daysCount = Math.floor(Math.abs((endDate - startDate) / msInDay)) + 1;
return daysCount;
</script>
<style scoped>
.demo-container {
height: 690px;
.dx-field {
padding: 8px;
.selected-days-wrapper {
font-size: 12px;
opacity: 0.5;
.multiline-label {
padding-top: 0;
</style>
window.exports = window.exports || {};
window.config = {
transpiler: 'plugin-babel',
meta: {
'*.vue': {
loader: 'vue-loader',
'*.ts': {
loader: 'demo-ts-loader',
'*.svg': {
loader: 'svg-loader',
'devextreme/time_zone_utils.js': {
'esModule': true,
'devextreme/localization.js': {
'esModule': true,
'devextreme/viz/palette.js': {
'esModule': true,
paths: {
'root:': '../../../../../',
'npm:': 'https://unpkg.com/',
map: {
'vue': 'npm:
[email protected] /dist/vue.esm-browser.js',
'vue-loader': 'npm:
[email protected] /index.js',
'demo-ts-loader': 'root:utils/demo-ts-loader.js',
'svg-loader': 'root:utils/svg-loader.js',
'mitt': 'npm:mitt/dist/mitt.umd.js',
'rrule': 'npm:
[email protected] /dist/es5/rrule.js',
'luxon': 'npm:
[email protected] /build/global/luxon.min.js',
'es6-object-assign': 'npm:
[email protected] ',
'devextreme': 'npm:
[email protected] /cjs',
'devextreme-vue': 'npm:
[email protected] /cjs',
'jszip': 'npm:
[email protected] /dist/jszip.min.js',
'devextreme-quill': 'npm:
[email protected] /dist/dx-quill.min.js',
'devexpress-diagram': 'npm:
[email protected] /dist/dx-diagram.js',
'devexpress-gantt': 'npm:
[email protected] /dist/dx-gantt.js',
'@devextreme/runtime': 'npm:@devextreme/
[email protected] ',
'inferno': 'npm:
[email protected] /dist/inferno.min.js',
'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js',
'inferno-create-element': 'npm:
[email protected] /dist/inferno-create-element.min.js',
'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js',
'inferno-hydrate': 'npm:
[email protected] /dist/inferno-hydrate.min.js',
'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js',
'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js',
'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js',
'plugin-babel': 'npm:
[email protected] /plugin-babel.js',
'systemjs-babel-build': 'npm:
[email protected] /systemjs-babel-browser.js',
// Prettier
'prettier/standalone': 'npm:
[email protected] /standalone.js',
'prettier/parser-html': 'npm:
[email protected] /parser-html.js',
packages: {
'devextreme-vue': {
main: 'index.js',
'devextreme': {
defaultExtension: 'js',
'devextreme/events/utils': {
main: 'index',
'devextreme/events': {
main: 'index',
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js',
packageConfigPaths: [
'npm:@devextreme/*/package.json',
'npm:@devextreme/
[email protected] /inferno/package.json',
babelOptions: {
sourceMaps: false,
stage0: true,
System.config(window.config);
import { createApp } from 'vue';
import App from './App.vue';
createApp(App).mount('#app');
<!DOCTYPE html>
<title>DevExtreme Demo</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.2.4/css/dx.light.css" />
<script type="module">
import * as vueCompilerSFC from "https://unpkg.com/@vue/
[email protected] /dist/compiler-sfc.esm-browser.js";
window.vueCompilerSFC = vueCompilerSFC;
</script>
<script src="https://unpkg.com/
[email protected] /lib/typescript.js"></script>
<script src="https://unpkg.com/
[email protected] /client/shim.min.js"></script>
<script src="https://unpkg.com/
[email protected] /dist/system.js"></script>
<script type="text/javascript" src="config.js"></script>
<script type="text/javascript">
System.import("./index.ts");
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"> </div>
</body>
</html>
All trademarks or registered trademarks are property of their respective owners.
Use of this site constitutes acceptance of the Developer Express Inc
Website Terms of Use
,
Privacy Policy (Updated)
, and
Cookie Settings
.
Use of DevExtreme UI components/libraries constitutes acceptance of the Developer Express Inc End User License Agreement.
FAQs:
Licensing
|
DevExpress Support Services
|
Supported Versions & Requirements
|
Maintenance Releases