Angular Scheduler Quickstart

Quickstart

Render your first scheduler: the CScheduler component and an events array.

A scheduler needs the <CScheduler> component and an array of events. Dates are ISO 8601 strings — with or without an explicit UTC offset:

Oct 19 – 25, 2026
19 Mon
20 Tue
21 Wed
22 Thu
23 Fri
24 Sat
25 Sun
08:00
09:00
10:00
11:00
12:00
13:00
14:00
15:00
16:00
17:00
09:00 AM – 10:00 AM
Kickoff
10:00 AM – 11:30 AM
Design review
10:30 AM – 12:00 PM
Pairing
02:00 PM – 03:00 PM
Sprint demo
ts
import { Component } from '@angular/core'
import { SchedulerComponent } from '@coreui/angular-scheduler'

const pad = (n: number) => String(n).padStart(2, '0')
const day = (offset: number) => {
  const date = new Date()
  date.setDate(date.getDate() - ((date.getDay() + 6) % 7) + offset)
  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`
}

@Component({
  selector: 'docs-scheduler-day-week-example',
  imports: [SchedulerComponent],
  template: `
    <c-scheduler defaultView="week" [dayStartHour]="8" [dayEndHour]="18" [events]="events" />
  `
})
export class SchedulerDayWeekExample {
  readonly events = [
    {
 id: 'kickoff', title: 'Kickoff', start: `${day(0)}T09:00`, end: `${day(0)}T10:00`
},
    {
 id: 'design', title: 'Design review', start: `${day(1)}T10:00`, end: `${day(1)}T11:30`, color: '#2eb85c'
},
    {
 id: 'pairing', title: 'Pairing', start: `${day(1)}T10:30`, end: `${day(1)}T12:00`
},
    {
 id: 'demo', title: 'Sprint demo', start: `${day(3)}T14:00`, end: `${day(3)}T15:00`
}
  ]
}

Reacting to changes

The scheduler owns its state after mounting. Every change — drag, resize, create, delete, repeat-rule edit — emits eventChange with the changed event and a revert callback:

<c-scheduler [events]="events" (eventChange)="onEventChange($event)" />
onEventChange({ action, event, revert }: EventChangePayload) {
  console.log(action, event)
  // persist to your API; call revert() if the server rejects it
}

See Inputs & outputs for the full surface.

Date and view

Pass defaultDate and defaultView to set where the scheduler starts; it then navigates on its own. Pass date or view to control them: the scheduler shows what you pass and asks for a change through dateChange and viewChange, so [(date)] and [(view)] work. A parent that keeps the old value keeps the scheduler where it is.

<c-scheduler [(date)]="date" [events]="events" />

Time zones

Pass an IANA zone to pin the scheduler to it; otherwise the browser’s zone is used. All wall-clock math — including DST transitions — happens in that zone:

<c-scheduler timeZone="Europe/Warsaw" [events]="events" />

Server rendering

When the scheduler is rendered on the server, pass timeZone and defaultDate: without them the server uses its own zone and day, the browser its own, and the markup no longer matches when it hydrates. The now indicator and the events of a dataSource appear once the scheduler mounts in the browser.

<c-scheduler timeZone="Europe/Warsaw" defaultDate="2026-08-11" [events]="events" />