Your search did not match any results.
Scheduler

Recurring Appointments

A recurring appointment repeats at a specified interval. A circular arrow glyph denotes such an appointment in the view.

Do the following to create a recurring appointment:

  1. Locate or create an appointment object in the dataSource.

  2. Specify the recurrenceRule property to configure the appointment frequency. Set this property according to the iCalendar RFC 2445 specification. A single data object with recurrenceRule creates an appointment series.

  3. Optionally, use the recurrenceException property to specify the start date and time of those appointments that you want to exclude from the series.

You can use custom fields that set recurrence. To enable them, specify their names in the Scheduler's recurrenceRuleExpr and recurrenceExceptionExpr properties.

Users can also create recurring appointments. The appointment details form contains a Repeat switch. When it is on, the form displays an additional set of fields to specify recurrence rules. Double-click an appointment and select Edit series to view the appointment details form with the recurrence fields. You can also select Edit appointment to view a single non-recurring appointment from the series.

Backend API
Copy to CodeSandBox
Apply
Reset
<dx-scheduler timeZone="America/Los_Angeles" [dataSource]="appointmentsData" [views]='["day", "week", "month"]' currentView="month" [currentDate]="currentDate" [startDayHour]="9" [height]="600"> <dxi-resource fieldExpr="roomId" label="room" [dataSource]="resourcesData" ></dxi-resource> </dx-scheduler>
import { NgModule, Component, enableProdMode } from '@angular/core'; import {BrowserModule} from '@angular/platform-browser'; import {platformBrowserDynamic} from '@angular/platform-browser-dynamic'; import {Appointment, Resource, Service} from './app.service'; import {DxSchedulerModule} from 'devextreme-angular'; if(!/localhost/.test(document.location.host)) { enableProdMode(); } @Component({ styleUrls: ['app/app.component.css'], selector: 'demo-app', templateUrl: 'app/app.component.html', providers: [Service] }) export class AppComponent { appointmentsData: Appointment[]; currentDate: Date = new Date(2020, 10, 25); resourcesData: Resource[]; constructor(service: Service) { this.appointmentsData = service.getAppointments(); this.resourcesData = service.getResources(); } } @NgModule({ imports: [ BrowserModule, DxSchedulerModule ], declarations: [AppComponent], bootstrap: [AppComponent] }) export class AppModule { } platformBrowserDynamic().bootstrapModule(AppModule)
import { Injectable } from "@angular/core"; export class Appointment { text: string; roomId: number[]; startDate: Date; endDate: Date; recurrenceRule?: string; recurrenceException?: string; } export class Resource { text: string; id: number; color: string; } let appointments: Appointment[] = [ { text: "Watercolor Landscape", roomId: [1], startDate: new Date("2020-11-01T17:30:00.000Z"), endDate: new Date("2020-11-01T19:00:00.000Z"), recurrenceRule: "FREQ=WEEKLY;BYDAY=MO,TH;COUNT=10" }, { text: "Oil Painting for Beginners", roomId: [2], startDate: new Date("2020-11-01T17:30:00.000Z"), endDate: new Date("2020-11-01T19:00:00.000Z"), recurrenceRule: "FREQ=WEEKLY;BYDAY=SU,WE;COUNT=10" }, { text: "Testing", roomId: [3], startDate: new Date("2020-11-01T20:00:00.000Z"), endDate: new Date("2020-11-01T21:00:00.000Z"), recurrenceRule: "FREQ=WEEKLY;BYDAY=SU;WKST=TU;INTERVAL=2;COUNT=2" }, { text: "Meeting of Instructors", roomId: [4], startDate: new Date("2020-11-01T17:00:00.000Z"), endDate: new Date("2020-11-01T17:15:00.000Z"), recurrenceRule: "FREQ=DAILY;BYDAY=TU;UNTIL=20201203" }, { text: "Recruiting students", roomId: [5], startDate: new Date("2020-10-24T18:00:00.000Z"), endDate: new Date("2020-10-24T19:00:00.000Z"), recurrenceRule: "FREQ=YEARLY;BYWEEKNO=50;WKST=SU", recurrenceException: "20201212T190000Z" }, { text: "Final exams", roomId: [3], startDate: new Date("2020-10-24T20:00:00.000Z"), endDate: new Date("2020-10-24T21:35:00.000Z"), recurrenceRule: "FREQ=YEARLY;BYWEEKNO=51;BYDAY=WE,TH" }, { text: "Monthly Planning", roomId: [4], startDate: new Date("2020-11-24T22:30:00.000Z"), endDate: new Date("2020-11-24T23:45:00.000Z"), recurrenceRule: "FREQ=MONTHLY;BYMONTHDAY=28;COUNT=1" }, { text: "Open Day", roomId: [5], startDate: new Date("2020-11-01T17:30:00.000Z"), endDate: new Date("2020-11-01T21:00:00.000Z"), recurrenceRule: "FREQ=YEARLY;BYYEARDAY=333" } ]; let resources: Resource[] = [ { text: "Room 101", id: 1, color: "#bbd806" }, { text: "Room 102", id: 2, color: "#f34c8a" }, { text: "Room 103", id: 3, color: "#ae7fcc" }, { text: "Meeting room", id: 4, color: "#ff8817" }, { text: "Conference hall", id: 5, color: "#03bb92" } ]; @Injectable() export class Service { getAppointments(): Appointment[] { return appointments; } getResources(): Resource[] { return resources; } }
// 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': 'npm:@angular', 'tslib': 'npm:tslib@2.3.0/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.1.5/cjs', 'devextreme/bundles/dx.all': 'npm:devextreme@21.1.5/bundles/dx.all.js', 'jszip': 'npm:jszip@3.7.0/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.3.1/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.1.25', 'devexpress-gantt': 'npm:devexpress-gantt@3.0.4', 'devextreme-angular': 'npm:devextreme-angular@21.1.5', '@devextreme/vdom': 'npm:@devextreme/vdom@1.2.2', 'inferno': 'npm:inferno@7.4.8/dist/inferno.min.js', 'inferno-compat': 'npm:inferno-compat@7.4.8/dist/inferno-compat.min.js', 'inferno-create-element': 'npm:inferno-create-element@7.4.8/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.8/dist/inferno-hydrate.min.js', 'inferno-clone-vnode': 'npm:inferno-clone-vnode@7.4.8/dist/inferno-clone-vnode.min.js', 'inferno-create-class': 'npm:inferno-create-class@7.4.8/dist/inferno-create-class.min.js', 'inferno-extras': 'npm:inferno-extras@7.4.8/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:@angular/*/package.json", "npm:@angular/common/*/package.json", "npm:rxjs/package.json", "npm:rxjs/operators/package.json", "npm:devextreme-angular/*/package.json", "npm:devextreme-angular/ui/*/package.json", "npm:devextreme-angular/package.json", "npm:devexpress-diagram/package.json", "npm:devexpress-gantt/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.1.5/css/dx.common.css" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/21.1.5/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.10.3/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>