Calendar
Documentation
The Calendar is a UI component that displays a calendar and allows an end user to select the required date within a specified date range.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you!
We appreciate your feedback.
We appreciate your feedback.
<div id="calendar-demo">
<div class="widget-container">
<dx-calendar
#calendar
id="calendar-container"
[min]="minDateValue"
[max]="maxDateValue"
[disabledDates]="disabledDates"
[firstDayOfWeek]="firstDay"
[disabled]="false"
[(value)]="currentValue"
[zoomLevel]="zoomLevels[0]"
[cellTemplate]="cellTemplate"
>
<span
*dxTemplate="let cell of 'custom'"
[ngClass]="getCellCssClass(cell.date)"
>
{{ cell.text }}
</span>
</dx-calendar>
</div>
<div class="options">
<div class="caption">Options</div>
<div class="option">
<dx-check-box
text="Specified min value"
[value]="false"
(onValueChanged)="setMinDate($event)"
>
</dx-check-box>
</div>
<div class="option">
<dx-check-box
text="Specified max value"
[value]="false"
(onValueChanged)="setMaxDate($event)"
>
</dx-check-box>
</div>
<div class="option">
<dx-check-box
text="Disable weekend"
[value]="false"
(onValueChanged)="disableWeekend($event)"
>
</dx-check-box>
</div>
<div class="option">
<dx-check-box
text="Monday as the first day of a week"
[value]="false"
(onValueChanged)="setFirstDay($event)"
>
</dx-check-box>
</div>
<div class="option">
<dx-check-box
text="Use the Custom Cell Template"
[value]="false"
(onValueChanged)="useCellTemplate($event)"
>
</dx-check-box>
</div>
<div class="option">
<dx-check-box
#calendarDisabled
[(value)]="calendar.disabled"
text="Disabled"
>
</dx-check-box>
</div>
<div class="option">
<span>Zoom level</span>
<dx-select-box
id="zoom-level"
[dataSource]="zoomLevels"
[(value)]="calendar.zoomLevel"
>
</dx-select-box>
</div>
<div class="option">
<span>Selected date</span>
<dx-date-box id="selected-date" width="100%" [(value)]="currentValue">
</dx-date-box>
</div>
</div>
</div>
import { Component, NgModule, enableProdMode } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import {
DxSelectBoxModule,
DxCheckBoxModule,
DxDateBoxModule,
DxCalendarModule,
DxTemplateModule,
} from 'devextreme-angular';
if (!/localhost/.test(document.location.host)) {
enableProdMode();
}
@Component({
selector: 'demo-app',
templateUrl: 'app/app.component.html',
styleUrls: ['app/app.component.css'],
})
export class AppComponent {
now: Date = new Date();
currentValue: Date = new Date();
firstDay = 0;
minDateValue: Date | null = null;
maxDateValue: Date | null = null;
disabledDates: Function | null = null;
zoomLevels: string[] = [
'month', 'year', 'decade', 'century',
];
cellTemplate = 'cell';
holydays: any = [[1, 0], [4, 6], [25, 11]];
isWeekend(date) {
const day = date.getDay();
return day === 0 || day === 6;
}
setMinDate(e) {
if (e.value) {
this.minDateValue = new Date(this.now.getTime() - 1000 * 60 * 60 * 24 * 3);
} else {
this.minDateValue = null;
}
}
setMaxDate(e) {
if (e.value) {
this.maxDateValue = new Date(this.now.getTime() + 1000 * 60 * 60 * 24 * 3);
} else {
this.maxDateValue = null;
}
}
disableWeekend(e) {
if (e.value) {
const that = this;
that.disabledDates = function (data) {
return data.view === 'month' && that.isWeekend(data.date);
};
} else {
this.disabledDates = null;
}
}
setFirstDay(e) {
if (e.value) {
this.firstDay = 1;
} else {
this.firstDay = 0;
}
}
useCellTemplate(e) {
if (e.value) {
this.cellTemplate = 'custom';
} else {
this.cellTemplate = 'cell';
}
}
getCellCssClass(date) {
let cssClass = '';
if (this.isWeekend(date)) { cssClass = 'weekend'; }
this.holydays.forEach((item) => {
if (date.getDate() === item[0] && date.getMonth() === item[1]) {
cssClass = 'holyday';
return false;
}
});
return cssClass;
}
}
@NgModule({
imports: [
BrowserModule,
DxSelectBoxModule,
DxCalendarModule,
DxCheckBoxModule,
DxDateBoxModule,
DxTemplateModule,
],
declarations: [AppComponent],
bootstrap: [AppComponent],
})
export class AppModule { }
platformBrowserDynamic().bootstrapModule(AppModule);
::ng-deep .widget-container {
margin-right: 320px;
}
::ng-deep #calendar-container {
margin: auto;
}
::ng-deep .dx-calendar-cell:not(.dx-calendar-other-month) .weekend,
::ng-deep .dx-calendar-cell:not(.dx-calendar-other-month) .holyday {
text-shadow: none;
font-weight: bold;
}
::ng-deep .dx-calendar-cell:not(.dx-calendar-other-month) .weekend {
color: #3030ff;
}
::ng-deep .dx-state-disabled.dx-calendar .dx-calendar-cell:not(.dx-calendar-other-month) .weekend {
color: #8080ff;
}
::ng-deep .dx-calendar-cell:not(.dx-calendar-other-month) .holyday {
color: #ff3030;
}
::ng-deep .dx-state-disabled.dx-calendar .dx-calendar-cell:not(.dx-calendar-other-month) .holyday {
color: #ff8080;
}
::ng-deep .options {
padding: 20px;
background-color: rgba(191, 191, 191, 0.15);
position: absolute;
right: 0;
top: 0;
bottom: 0;
width: 260px;
}
::ng-deep .caption {
font-weight: 500;
font-size: 18px;
}
::ng-deep .option {
margin-top: 10px;
}
// 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.config = {
transpiler: 'ts',
typescriptOptions: {
module: 'system',
emitDecoratorMetadata: true,
experimentalDecorators: true,
},
meta: {
'typescript': {
'exports': 'ts',
},
'devextreme/localization.js': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
},
map: {
'ts': 'npm:plugin-typescript@8.0.0/lib/plugin.js',
'typescript': 'npm:typescript@3.5.3/lib/typescript.js',
'@angular/core': 'npm:@angular/core@12.2.13',
'@angular/platform-browser': 'npm:@angular/platform-browser@12.2.13',
'@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic@12.2.13',
'@angular/forms': 'npm:@angular/forms@12.2.13',
'@angular/common/http': 'npm:@angular/common@12.2.13/bundles/common-http.umd.js',
'@angular/common': 'npm:@angular/common@12.2.13',
'@angular/compiler': 'npm:@angular/compiler@12.2.13',
'tslib': 'npm:tslib@2.3.1/tslib.js',
'rxjs': 'npm:rxjs@6.4.0',
'rrule': 'npm:rrule@2.6.6/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.28.0/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@21.2.3/cjs',
'devextreme/bundles/dx.all': 'npm:devextreme@21.2.3/bundles/dx.all.js',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.5.5/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.1.37',
'devexpress-gantt': 'npm:devexpress-gantt@3.1.24',
'devextreme-angular': 'npm:devextreme-angular@21.2.3',
'@devextreme/vdom': 'npm:@devextreme/vdom@2.2.3',
'@devextreme/runtime': 'npm:@devextreme/runtime@2.3.8',
'inferno': 'npm:inferno@7.4.10/dist/inferno.min.js',
'inferno-compat': 'npm:inferno-compat@7.4.10/dist/inferno-compat.min.js',
'inferno-create-element': 'npm:inferno-create-element@7.4.10/dist/inferno-create-element.min.js',
'inferno-dom': 'npm:inferno-dom@1.0.7/dist/inferno-dom.min.js',
'inferno-hydrate': 'npm:inferno-hydrate@7.4.10/dist/inferno-hydrate.min.js',
'inferno-clone-vnode': 'npm:inferno-clone-vnode@7.4.10/dist/inferno-clone-vnode.min.js',
'inferno-create-class': 'npm:inferno-create-class@7.4.10/dist/inferno-create-class.min.js',
'inferno-extras': 'npm:inferno-extras@7.4.10/dist/inferno-extras.min.js',
},
packages: {
'app': {
main: './app.component.ts',
defaultExtension: 'ts',
},
'devextreme': {
defaultExtension: 'js',
},
'@devextreme/vdom': {
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/runtime@2.3.8/inferno/package.json',
'npm:@angular/*/package.json',
'npm:@angular/common/*/package.json',
'npm:rxjs@6.4.0/package.json',
'npm:rxjs@6.4.0/operators/package.json',
'npm:devextreme-angular/*/package.json',
'npm:devextreme-angular@21.2.3/ui/*/package.json',
'npm:devextreme-angular@21.2.3/package.json',
'npm:devexpress-diagram@2.1.37/package.json',
'npm:devexpress-gantt@3.1.24/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/21.2.3/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/21.2.3/css/dx.light.css" />
<script src="https://unpkg.com/core-js@2.4.1/client/shim.min.js"></script>
<script src="https://unpkg.com/zone.js@0.11.4/dist/zone.js"></script>
<script src="https://unpkg.com/reflect-metadata@0.1.3/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>