DevExtreme v24.1 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

Angular Scheduler - Disabled Date/Time Ranges

This demo shows how to disable specific days, dates, and times when a user cannot schedule an appointment. In the demo, appointments are disabled for weekends, certain individual dates (e.g., May 25th), and the time period from 12:00pm to 1:00pm.

Backend API
<dx-scheduler [dataSource]="dataSource" [views]="views" [currentView]="currentView" [currentDate]="currentDate" [firstDayOfWeek]="0" [startDayHour]="9" [endDayHour]="19" [showAllDayPanel]="false" [height]="730" dataCellTemplate="dataCellTemplate" dateCellTemplate="dateCellTemplate" timeCellTemplate="timeCellTemplate" (onAppointmentFormOpening)="onAppointmentFormOpening($event)" (onAppointmentAdding)="onAppointmentAdding($event)" (onAppointmentUpdating)="onAppointmentUpdating($event)" (onOptionChanged)="onOptionChanged($event)" > <div *dxTemplate="let dataCell of 'dataCellTemplate'" [ngClass]="{ 'disable-date': (isDisableDate | apply : dataCell.startDate), dinner: !(isDisableDate | apply : dataCell.startDate) && (isDinner | apply : dataCell.startDate), 'dx-scheduler-date-table-cell-text': currentView === 'month' }" > {{ currentView === "month" ? (dataCell.startDate | date) : "" }} </div> <div *dxTemplate="let dateCell of 'dateCellTemplate'" [ngClass]="{ 'disable-date': (isDisabledDateCell | apply : dateCell.date) }" > {{ dateCell.text }} </div> <div *dxTemplate="let timeCell of 'timeCellTemplate'" [ngClass]="{ dinner: isDinner | apply : timeCell.date }" > {{ timeCell.text }} <div *ngIf="hasCoffeeCupIcon | apply : timeCell.date" class="cafe"></div> </div> </dx-scheduler>
import { NgModule, Component, enableProdMode, Pipe, PipeTransform, } from '@angular/core'; import { BrowserModule } from '@angular/platform-browser'; import { platformBrowserDynamic } from '@angular/platform-browser-dynamic'; import { DxSchedulerComponent, DxSchedulerModule, DxTemplateModule } from 'devextreme-angular'; import DataSource from 'devextreme/data/data_source'; import notify from 'devextreme/ui/notify'; import { DxSchedulerTypes } from 'devextreme-angular/ui/scheduler'; import { DxFormComponent } from 'devextreme-angular/ui/form'; import { DataService } from './app.service'; @Pipe({ name: 'apply' }) export class ApplyPipe<TArgs, TReturn> implements PipeTransform { transform(func: ((...args: TArgs[]) => TReturn), ...args: TArgs[]): TReturn { return func(...args); } } if (!/localhost/.test(document.location.host)) { enableProdMode(); } @Component({ selector: 'demo-app', templateUrl: `app/app.component.html`, styleUrls: [`app/app.component.css`], providers: [DataService], }) export class AppComponent { dataSource: DataSource; dinnerTime = this.dataService.getDinnerTime(); holidays = this.dataService.getHolidays(); currentDate = new Date(2021, 3, 27); views = ['workWeek', 'month']; currentView = this.views[0]; constructor(public dataService: DataService) { this.dataSource = new DataSource({ store: dataService.getData(), }); } onOptionChanged = (e: DxSchedulerTypes.OptionChangedEvent) => { if (e.name === 'currentView') { this.currentView = e.value; } }; onAppointmentFormOpening = (e: DxSchedulerTypes.AppointmentFormOpeningEvent) => { const startDate = e.appointmentData.startDate as Date; if (!this.isValidAppointmentDate(startDate)) { e.cancel = true; this.notifyDisableDate(); } this.applyDisableDatesToDateEditors(e.form); }; onAppointmentAdding = (e: DxSchedulerTypes.AppointmentAddingEvent) => { const isValidAppointment = this.isValidAppointment(e.component, e.appointmentData); if (!isValidAppointment) { e.cancel = true; this.notifyDisableDate(); } }; onAppointmentUpdating = (e: DxSchedulerTypes.AppointmentUpdatingEvent) => { const isValidAppointment = this.isValidAppointment(e.component, e.newData); if (!isValidAppointment) { e.cancel = true; this.notifyDisableDate(); } }; notifyDisableDate = () => { notify('Cannot create or move an appointment/event to disabled time/date regions.', 'warning', 1000); }; isHoliday = (date: Date) => { const localeDate = date.toLocaleDateString(); return this.holidays.filter((holiday) => holiday.toLocaleDateString() === localeDate).length > 0; }; isWeekend = (date: Date) => { const day = date.getDay(); return day === 0 || day === 6; }; isDinner = (date: Date) => { const hours = date.getHours(); return hours >= this.dinnerTime.from && hours < this.dinnerTime.to; }; isDisableDate = (date: Date) => this.isHoliday(date) || this.isWeekend(date); isDisabledDateCell = (date: Date) => (this.currentView === 'month' ? this.isWeekend(date) : this.isDisableDate(date)); hasCoffeeCupIcon = (date: Date) => { const hours = date.getHours(); const minutes = date.getMinutes(); return hours === this.dinnerTime.from && minutes === 0; }; isValidAppointment = (component: DxSchedulerComponent['instance'], appointmentData: DxSchedulerTypes.Appointment) => { const startDate = new Date(appointmentData.startDate); const endDate = new Date(appointmentData.endDate); const cellDuration = component.option('cellDuration'); return this.isValidAppointmentInterval(startDate, endDate, cellDuration); }; isValidAppointmentInterval = (startDate: Date, endDate: Date, cellDuration: number) => { const edgeEndDate = new Date(endDate.getTime() - 1); if (!this.isValidAppointmentDate(edgeEndDate)) { return false; } const durationInMs = cellDuration * 60 * 1000; const date = startDate; while (date <= endDate) { if (!this.isValidAppointmentDate(date)) { return false; } const newDateTime = date.getTime() + durationInMs - 1; date.setTime(newDateTime); } return true; }; isValidAppointmentDate = (date: Date) => !this.isHoliday(date) && !this.isDinner(date) && !this.isWeekend(date); applyDisableDatesToDateEditors = (form: DxFormComponent['instance']) => { const holidays = this.dataService.getHolidays(); const startDateEditor = form.getEditor('startDate'); startDateEditor.option('disabledDates', holidays); const endDateEditor = form.getEditor('endDate'); endDateEditor.option('disabledDates', holidays); }; } @NgModule({ imports: [ BrowserModule, DxSchedulerModule, DxTemplateModule, ], declarations: [AppComponent, ApplyPipe], bootstrap: [AppComponent], }) export class AppModule { } platformBrowserDynamic().bootstrapModule(AppModule);
@-moz-document url-prefix() { .dx-scheduler-work-space-month .dx-scheduler-date-table-cell { position: relative; } .dx-scheduler-work-space-month .dx-scheduler-date-table-cell .disable-date { position: absolute; width: 100%; height: 100%; } } .disable-date, .dinner { height: 100%; width: 100%; } ::ng-deep .disable-date { background-image: repeating-linear-gradient( 135deg, rgba(244, 67, 54, 0.1), rgba(244, 67, 54, 0.1) 4px, transparent 4px, transparent 9px ); color: #9b6467; } ::ng-deep .dx-scheduler-header-panel-cell .disable-date { display: flex; flex-direction: column; justify-content: center; } ::ng-deep .dx-theme-fluent .dx-scheduler-header-panel-cell .disable-date, ::ng-deep .dx-theme-material .dx-scheduler-header-panel-cell .disable-date { flex-direction: row; align-items: flex-end; justify-content: initial; } .dinner { background: rgba(255, 193, 7, 0.2); } ::ng-deep .dx-scheduler-time-panel-cell .dinner { color: rgba(255, 193, 7); font-weight: 400; background: transparent; } .dx-draggable { cursor: auto; } ::ng-deep td.dx-scheduler-time-panel-cell .dinner .cafe { height: 200%; width: 100%; left: 50%; -webkit-mask: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" height="24" viewBox="0 0 24 24" width="24"><path d="M0 0h24v24H0V0z" fill="none"/><path d="M20 3H4v10c0 2.21 1.79 4 4 4h6c2.21 0 4-1.79 4-4v-3h2c1.11 0 2-.9 2-2V5c0-1.11-.89-2-2-2zm0 5h-2V5h2v3zM4 19h16v2H4z"/></svg>'); -webkit-mask-repeat: no-repeat; -webkit-mask-position-y: 50%; -webkit-mask-position-x: 100%; margin-top: -4px; background-color: #ffc107; } ::ng-deep .dx-scheduler-date-table-cell { padding: 0; opacity: 1; } @media all and (-ms-high-contrast: none) { ::ng-deep td.dx-scheduler-time-panel-cell .dinner .cafe { background-color: transparent; } }
import { Injectable } from '@angular/core'; export class Data { text: string; startDate: Date; endDate: Date; } const data: Data[] = [ { text: 'Website Re-Design Plan', startDate: new Date(2021, 3, 26, 9, 30), endDate: new Date(2021, 3, 26, 11, 30), }, { text: 'Install New Router in Dev Room', startDate: new Date(2021, 3, 26, 13), endDate: new Date(2021, 3, 26, 14), }, { text: 'Approve Personal Computer Upgrade Plan', startDate: new Date(2021, 3, 27, 10), endDate: new Date(2021, 3, 27, 11), }, { text: 'Final Budget Review', startDate: new Date(2021, 3, 27, 13, 30), endDate: new Date(2021, 3, 27, 15), }, { text: 'New Brochures', startDate: new Date(2021, 3, 26, 15), endDate: new Date(2021, 3, 26, 16, 15), }, { text: 'Install New Database', startDate: new Date(2021, 3, 28, 9, 45), endDate: new Date(2021, 3, 28, 12), }, { text: 'Approve New Online Marketing Strategy', startDate: new Date(2021, 3, 28, 14, 30), endDate: new Date(2021, 3, 28, 16, 30), }, { text: 'Upgrade Personal Computers', startDate: new Date(2021, 3, 27, 15, 30), endDate: new Date(2021, 3, 27, 16, 45), }, { text: 'Prepare 2021 Marketing Plan', startDate: new Date(2021, 4, 3, 13), endDate: new Date(2021, 4, 3, 15), }, { text: 'Brochure Design Review', startDate: new Date(2021, 4, 4, 15, 30), endDate: new Date(2021, 4, 5), }, { text: 'Create Icons for Website', startDate: new Date(2021, 3, 30, 10), endDate: new Date(2021, 3, 30, 12), }, { text: 'Upgrade Server Hardware', startDate: new Date(2021, 3, 30, 16, 30), endDate: new Date(2021, 3, 30, 18), }, { text: 'Submit New Website Design', startDate: new Date(2021, 4, 5, 10), endDate: new Date(2021, 4, 5, 11, 30), }, { text: 'Launch New Website', startDate: new Date(2021, 3, 30, 14, 30), endDate: new Date(2021, 3, 30, 16, 10), }, ]; @Injectable() export class DataService { getData() { return data; } getDinnerTime() { return { from: 12, to: 13 }; } getHolidays() { return [ new Date(2021, 3, 29), new Date(2021, 5, 6), ]; } }
// 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/ const componentNames = [ 'accordion', 'action-sheet', 'autocomplete', 'bar-gauge', 'box', 'bullet', 'button-group', 'button', 'calendar', 'chart', 'check-box', 'circular-gauge', 'color-box', 'context-menu', 'data-grid', 'date-box', 'date-range-box', 'defer-rendering', 'diagram', 'draggable', 'drawer', 'drop-down-box', 'drop-down-button', 'file-manager', 'file-uploader', 'filter-builder', 'form', 'funnel', 'gallery', 'gantt', 'html-editor', 'linear-gauge', 'list', 'load-indicator', 'load-panel', 'lookup', 'map', 'menu', 'multi-view', 'nested', 'number-box', 'pie-chart', 'pivot-grid-field-chooser', 'pivot-grid', 'polar-chart', 'popover', 'popup', 'progress-bar', 'radio-group', 'range-selector', 'range-slider', 'recurrence-editor', 'resizable', 'responsive-box', 'sankey', 'scheduler', 'scroll-view', 'select-box', 'slider', 'sortable', 'sparkline', 'speed-dial-action', 'splitter', 'switch', 'tab-panel', 'tabs', 'tag-box', 'text-area', 'text-box', 'tile-view', 'toast', 'toolbar', 'tooltip', 'tree-list', 'tree-map', 'tree-view', 'validation-group', 'validation-summary', 'validator', 'vector-map', ]; 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, }, '@angular/platform-browser-dynamic': { 'esModule': true, }, '@angular/platform-browser': { 'esModule': true, }, '@angular/core': { 'esModule': true, }, '@angular/common': { 'esModule': true, }, '@angular/common/http': { 'esModule': true, }, '@angular/compiler': { 'esModule': true, }, '@angular/animations': { 'esModule': true, }, '@angular/forms': { 'esModule': true, }, }, paths: { 'npm:': 'https://unpkg.com/', 'bundles:': '../../../../bundles/', }, map: { 'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', /* @angular */ '@angular/compiler': 'bundles:@angular/compiler.umd.js', '@angular/platform-browser-dynamic': 'bundles:@angular/platform-browser-dynamic.umd.js', '@angular/core': 'bundles:@angular/core.umd.js', '@angular/core/primitives/signals': 'bundles:@angular/core.primitives.signals.umd.js', '@angular/common': 'bundles:@angular/common.umd.js', '@angular/common/http': 'bundles:@angular/common-http.umd.js', '@angular/platform-browser': 'bundles:@angular/platform-browser.umd.js', '@angular/platform-browser/animations': 'bundles:@angular/platform-browser.umd.js', '@angular/forms': 'bundles:@angular/forms.umd.js', /* devextreme */ 'devextreme': 'npm:devextreme@24.1.6/cjs', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.13', 'devextreme/bundles/dx.all': 'npm:devextreme@24.1.6/bundles/dx.all.js', 'devextreme-quill': 'npm:devextreme-quill@1.7.1/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.11', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.56', /* devextreme-angular umd maps */ 'devextreme-angular': 'bundles:devextreme-angular/devextreme-angular.umd.js', 'devextreme-angular/core': 'bundles:devextreme-angular/devextreme-angular-core.umd.js', 'devextreme-angular/http': 'bundles:devextreme-angular/devextreme-angular-http.umd.js', ...componentNames.reduce((acc, name) => { acc[`devextreme-angular/ui/${name}`] = `bundles:devextreme-angular/devextreme-angular-ui-${name}.umd.js`; return acc; }, {}), 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', 'tslib': 'npm:tslib@2.6.1/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', '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.8/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.8/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.13/inferno/package.json', 'npm:rxjs@7.5.3/package.json', 'npm:rxjs@7.5.3/operators/package.json', 'npm:devexpress-diagram@2.2.11/package.json', 'npm:devexpress-gantt@4.1.56/package.json', ], }; System.config(window.config); // System.import('@angular/compiler').catch(console.error.bind(console));
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <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=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/24.1.6/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.13.3/bundles/zone.umd.min.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>

To implement this functionality in your application, follow the steps below:

  1. Implement custom date/time validation functions
    These functions should check whether a date or time is available. This demo includes the date/time validation functions listed below. In your application, they can be different.

    • isValidAppointment
      Prepares data and begins validation.
    • isValidAppointmentInterval
      Validates a date/time interval.
    • isValidAppointmentDate
      Calls the isHoliday, isWeekend, and isDinner functions.
    • isHoliday / isWeekend / isDinner
      Check whether a date/time interval is a holiday, a weekend, or dinner time.
  2. Validate appointments before they are created or updated
    Before an appointment is created or updated, the Scheduler executes the onAppointmentAdding and onAppointmentUpdating functions. Use them to start validation. If a date or time is invalid, cancel the creation or update. Implement the same logic in the onAppointmentFormOpening function so that users cannot open the appointment details form for a disabled date or time.

  3. Customize the appointment details form
    The appointment details form includes two calendars that allow users to select an appointment's start and end date/time. You should also disable dates in these calendars. Review the applyDisableDatesToDateEditors function to see how this is done. Call this function from onAppointmentFormOpening.

  4. Customize the timetable appearance
    Use templates to customize the appearance of data cells (dataCellTemplate), time cells (timeCellTemplate), and date cells (dateCellTemplate). In this demo, date cell customization is visible only in the Month view. To switch to this view, use the view switcher in the Scheduler's upper right corner.