Components
    • Barcodes
    • Buttons
    • Charts
    • Conversational UIupdated
    • Data Query
    • Date Inputs
    • Date Math
    • Dialogsupdated
    • Drawing
    • Dropdowns
    • Editorupdated
    • Excel Export
    • File Saver
    • Filterupdated
    • Gantt
    • Gauges
    • Gridupdated
    • Icons
    • Indicators
    • Inputs
    • Labels
    • Layoutupdated
    • ListBoxnew
    • ListView
    • Mapbeta
    • Menus
    • Navigation
    • Notification
    • Pager
    • PDF Export
    • PivotGridbeta
    • Popup
    • ProgressBars
    • Ripple
    • Schedulerupdated
    • ScrollView
    • Sortable
    • ToolBar
    • Tooltips
    • TreeList
    • TreeViewupdated
    • Typography
    • Uploads
    Styling & Themes
    Common Features
    Project Setup
    Knowledge Base
    Sample Applications
    Virtual Classroom
    FAQ
    Troubleshooting
Components / Date Inputs / API / CalendarComponent / 
New to Kendo UI for Angular? Start a free 30-day trial

CalendarComponent

Represents the Kendo UI Calendar component for Angular.

@Component({
selector: 'my-app',
template: `
 <kendo-calendar></kendo-calendar>
`
})
export class AppComponent { }

Selector

kendo-calendar

Export Name

Accessible in templates as #kendoCalendarInstance="kendo-calendar"

Inputs

NameTypeDefaultDescription

activeView

CalendarView

Defines the active view that the Calendar initially renders (see example). By default, the active view is month.

You have to set activeView within the topView-bottomView range.

animateNavigation

boolean

false

Determines whether to enable animation when navigating to previous/next view. Applies to the classic Calendar only.

This feature uses the Web Animations API. In order to run the animation in browsers that do not support it, you need the web-animations-js polyfill.

bottomView

CalendarView

Defines the bottommost view to which the user can navigate (see example).

disabled

boolean

Sets or gets the disabled property of the Calendar and determines whether the component is active (see example).

navigation

boolean

Sets or gets the navigation property of the Calendar and determines whether the navigation side-bar will be displayed (see example). Applies to the infinite Calendar only.

rangeValidation

boolean

Determines whether the built-in min or max validators are enforced when validating a form.

selection

CalendarSelection

Sets the Calendar selection mode (see example).

The available values are:

  • single (default)
  • multiple

tabindex

number

Sets or gets the tabindex property of the Calendar. Based on the HTML tabindex behavior, it determines whether the component is focusable.

topView

CalendarView

Defines the topmost view to which the user can navigate (see example).

weekNumber

boolean

Determines whether to display a week number column in the month view (see example).

disabledDates

Date[] | Day[] | (date: Date) => boolean

Sets the dates of the Calendar that will be disabled (see example).

focusedDate

Date

Sets or gets the focusedDate property of the Calendar and defines the focused date of the component (see example).

If the Calendar is out of the min or max range, it normalizes the defined focusedDate.

max

Date

Sets or gets the max property of the Calendar and defines the maximum allowed date value (see example). By default, the max value is 2099-12-31.

min

Date

Sets or gets the min property of the Calendar and defines the minimum allowed date value (see example). By default, the min value is 1900-1-1.

type

CalendarType

Specifies the Calendar type.

The possible values are:

  • infinite (default)
  • classic

value

any

Sets or gets the value property of the Calendar and defines the selected value of the component.

The value has to be a valid JavaScript Date instance when in single selection mode or an array of valid JavaScript Date instances when in multiple selection mode.

Events

NameTypeDescription

activeViewChange

EventEmitter<CalendarView>

Fires when the active view is changed (more information and example).

activeViewDateChange

EventEmitter<Date>

Fires when the active view date is changed (more information and example). Applies to the infinite Calendar only.

navigate

EventEmitter<{ activeView: CalendarView; focusedDate: Date; }>

Fires when navigating in the currently active view (more information and example).

valueChange

EventEmitter<any>

Fires when the value is changed (more information and example).

Methods

blur

Blurs the Calendar component.

focus

Focuses the host element of the Calendar.

@Component({
selector: 'my-app',
template: `
 <button (click)="calendar.focus()">Focus calendar</button>
 <kendo-calendar #calendar></kendo-calendar>
`
})
export class AppComponent { }

In this article

Not finding the help you need?

Contact Support