Calendar
When you add a Calendar to an application, you need to specify its value in one of the following formats:
-
Date objects
-
The number of milliseconds since 00:00:00 on January 1, 1970
-
Strings that match the following patterns:
- 'yyyy-MM-dd'
- 'yyyy-MM-ddTHH:mm:ss'
- 'yyyy-MM-ddTHH:mm:ssZ'
- 'yyyy-MM-ddTHH:mm:ssx'
This demo shows how to use additional properties to customize your Calendar. You can toggle the checkboxes on the right to change the Calendar in real time.
Disable Dates
Use the min and max properties to specify the range of available dates. In this demo, these properties limit the range to three days before and after the current date. Enable the "Specified min value" and "Specified max value" checkboxes to apply the properties.
If you need to disable specific dates, use the disabledDates property. Toggle the "Disable weekend" checkbox to see how this setting affects the component's behavior. You can specify either an array of predefined dates or a function that determines whether a date is available.
Set the Beginning of the Week
To specify the first day of the week, pass its index (0 - for Sunday, 1 - for Monday, and so on) to the firstDayOfWeek property.
Handle Value Change
To handle value changes, use two-way binding to bind the value properties of different components . In this demo, you can use the DateBox or Calendar component to change the date because their value properties are bound.
Customize Cell Appearance
Use the cellTemplate property to customize cell appearance. In this demo, when you toggle the "Use the Custom Cell Template" checkbox, all the weekends on the Calendar become blue, and all the holidays become red. You can set your own function that changes the class of the span element that contains cell text.
Other Customizations
Set the disabled property to disable the Calendar.
To specify the initial calendar view (month, year, decade, or century), set the zoomLevel property.
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)"
>
{{ 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, view }) {
let cssClass = '';
if (view === 'month') {
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@4.3.5/lib/typescript.js',
'@angular/core': 'npm:@angular/core@12.2.16',
'@angular/platform-browser': 'npm:@angular/platform-browser@12.2.16',
'@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic@12.2.16',
'@angular/forms': 'npm:@angular/forms@12.2.16',
'@angular/common': 'npm:@angular/common@12.2.16',
'@angular/compiler': 'npm:@angular/compiler@12.2.16',
'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.7/cjs',
'devextreme/bundles/dx.all': 'npm:devextreme@21.2.7/bundles/dx.all.js',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.5.14/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.1.47',
'devexpress-gantt': 'npm:devexpress-gantt@4.0.13',
'devextreme-angular': 'npm:devextreme-angular@21.2.7',
'@devextreme/runtime': 'npm:@devextreme/runtime@2.3.14',
'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js',
'inferno-compat': 'npm:inferno-compat@7.4.11/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@7.4.11/dist/inferno-clone-vnode.min.js',
'inferno-create-class': 'npm:inferno-create-class@7.4.11/dist/inferno-create-class.min.js',
'inferno-extras': 'npm:inferno-extras@7.4.11/dist/inferno-extras.min.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',
},
},
packageConfigPaths: [
'npm:@devextreme/*/package.json',
'npm:@devextreme/runtime@2.3.14/inferno/package.json',
'npm:@angular/*/package.json',
'npm:@angular/common@12.2.16/*/package.json',
'npm:rxjs@6.4.0/package.json',
'npm:rxjs@6.4.0/operators/package.json',
'npm:devextreme-angular@21.2.7/*/package.json',
'npm:devextreme-angular@21.2.7/ui/*/package.json',
'npm:devextreme-angular@21.2.7/package.json',
'npm:devexpress-diagram@2.1.47/package.json',
'npm:devexpress-gantt@4.0.13/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.7/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/21.2.7/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>