Overview
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.
Thank you for the feedback!
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Backend API
<div class="dx-fieldset">
<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>
</div>
<div class="dx-field-value">
<dx-date-range-box
[(value)]="currentValue"
(onValueChanged)="currentValueChanged($event)"
>
</dx-date-range-box>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Custom format</div>
<div class="dx-field-value">
<dx-date-range-box [value]="initialValue" displayFormat="EEEE, MMM dd">
</dx-date-range-box>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Use buttons to apply selection</div>
<div class="dx-field-value">
<dx-date-range-box applyValueMode="useButtons"></dx-date-range-box>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Single-calendar view</div>
<div class="dx-field-value">
<dx-date-range-box [multiView]="false"></dx-date-range-box>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Calendar only appears on icon click</div>
<div class="dx-field-value">
<dx-date-range-box [openOnFieldClick]="false"></dx-date-range-box>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Limit available dates (this month)</div>
<div class="dx-field-value">
<dx-date-range-box [min]="min" [max]="max"></dx-date-range-box>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Disable out of range selection</div>
<div class="dx-field-value">
<dx-date-range-box [disableOutOfRangeSelection]="true">
</dx-date-range-box>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Clear button</div>
<div class="dx-field-value">
<dx-date-range-box [showClearButton]="true" [value]="initialValue">
</dx-date-range-box>
</div>
</div>
</div>
import { Component, NgModule, enableProdMode } from '@angular/core';
import { BrowserModule, BrowserTransferStateModule } from '@angular/platform-browser';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { DxDateRangeBoxModule } from 'devextreme-angular';
if (!/localhost/.test(document.location.host)) {
enableProdMode();
}
declare var __moduleName: string;
const msInDay = 1000 * 60 * 60 * 24;
const now = new Date();
const initialValue: [Date, Date] = [
new Date(now.getTime() - msInDay * 3),
new Date(now.getTime() + msInDay * 3),
];
function convertRangeToDays([startDate, endDate]) {
const diffInDay = Math.floor(Math.abs((endDate - startDate) / msInDay));
return diffInDay + 1;
}
@Component({
selector: 'demo-app',
templateUrl: 'app.component.html',
styleUrls: ['app.component.css'],
moduleId: __moduleName,
})
export class AppComponent {
currentValue: [Date, Date] = initialValue;
initialValue: [Date, Date] = initialValue;
min: Date = null;
max: Date = null;
selectedDays: number = convertRangeToDays(initialValue);
constructor() {
const lastDay = new Date(now.getFullYear(), now.getMonth() + 1, 0).getDate();
this.min = new Date(now.setDate(1));
this.max = new Date(now.setDate(lastDay));
}
currentValueChanged({ value: [startDate, endDate] }) {
let daysCount = 0;
if (startDate && endDate) {
daysCount = convertRangeToDays([startDate, endDate]);
}
this.selectedDays = daysCount;
}
}
@NgModule({
imports: [
BrowserModule,
BrowserTransferStateModule,
DxDateRangeBoxModule,
],
declarations: [AppComponent],
bootstrap: [AppComponent],
})
export class AppModule { }
platformBrowserDynamic().bootstrapModule(AppModule);
::ng-deep .demo-container {
height: 690px;
}
::ng-deep .dx-field {
padding: 8px;
}
::ng-deep .selected-days-wrapper {
font-size: 12px;
opacity: 0.5;
}
::ng-deep .multiline-label {
padding-top: 0;
}
// In real applications, you should not transpile code in the browser.
// You can see how to create your own application with Angular and DevExtreme here:
// https://js.devexpress.com/Documentation/Guide/Angular_Components/Getting_Started/Create_a_DevExtreme_Application/
window.exports = window.exports || {};
window.config = {
transpiler: 'ts',
typescriptOptions: {
module: 'system',
emitDecoratorMetadata: true,
experimentalDecorators: true,
},
meta: {
'typescript': {
'exports': 'ts',
},
'devextreme/time_zone_utils.js': {
'esModule': true,
},
'devextreme/localization.js': {
'esModule': true,
},
'devextreme/viz/palette.js': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
},
map: {
'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js',
'typescript': 'npm:typescript@4.2.4/lib/typescript.js',
'@angular/core': 'npm:@angular/core@12.2.17',
'@angular/platform-browser': 'npm:@angular/platform-browser@12.2.17',
'@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic@12.2.17',
'@angular/forms': 'npm:@angular/forms@12.2.17',
'@angular/common': 'npm:@angular/common@12.2.17',
'@angular/compiler': 'npm:@angular/compiler@12.2.17',
'tslib': 'npm:tslib@2.6.2/tslib.js',
'rxjs': 'npm:rxjs@7.5.3/dist/bundles/rxjs.umd.js',
'rxjs/operators': 'npm:rxjs@7.5.3/dist/cjs/operators/index.js',
'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.28.1/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@23.2.5/cjs',
'devextreme/bundles/dx.all': 'npm:devextreme@23.2.5/bundles/dx.all.js',
'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.6.4/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.5',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.51',
'devextreme-angular': 'npm:devextreme-angular@23.2.5',
'@devextreme/runtime': 'npm:@devextreme/runtime@3.0.12',
'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js',
'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js',
'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js',
'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js',
'inferno-hydrate': 'npm:inferno-hydrate@7.4.11/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',
// Prettier
'prettier/standalone': 'npm:prettier@2.8.4/standalone.js',
'prettier/parser-html': 'npm:prettier@2.8.4/parser-html.js',
},
packages: {
'app': {
main: './app.component.ts',
defaultExtension: 'ts',
},
'devextreme': {
defaultExtension: 'js',
},
'devextreme/events/utils': {
main: 'index',
},
'devextreme/events': {
main: 'index',
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js',
},
'rxjs': {
defaultExtension: 'js',
},
'rxjs/operators': {
defaultExtension: 'js',
},
},
packageConfigPaths: [
'npm:@devextreme/*/package.json',
'npm:@devextreme/runtime@3.0.12/inferno/package.json',
'npm:@angular/*/package.json',
'npm:@angular/common@12.2.17/*/package.json',
'npm:rxjs@7.5.3/package.json',
'npm:rxjs@7.5.3/operators/package.json',
'npm:devextreme-angular@23.2.5/*/package.json',
'npm:devextreme-angular@23.2.5/ui/*/package.json',
'npm:devextreme-angular@23.2.5/package.json',
'npm:devexpress-diagram@2.2.5/package.json',
'npm:devexpress-gantt@4.1.51/package.json',
],
};
System.config(window.config);
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<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.5/css/dx.light.css" />
<script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script>
<script src="https://unpkg.com/zone.js@0.12.0/dist/zone.js"></script>
<script src="https://unpkg.com/reflect-metadata@0.1.13/Reflect.js"></script>
<script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script>
<script src="config.js"></script>
<script>
System.import("app").catch(console.error.bind(console));
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<demo-app>Loading...</demo-app>
</div>
</body>
</html>