# ASP.NET Core Calendar Overview

The Telerik UI Calendar TagHelper and HtmlHelper for ASP.NET Core are server-side wrappers for the Kendo UI Calendar widget.

The Calendar renders a graphical calendar that provides navigation and selection functionalities.

* [Demo page for the Calendar HtmlHelper](https://demos.telerik.com/aspnet-core/calendar/index)

* [Demo page for the Calendar TagHelper](https://demos.telerik.com/aspnet-core/calendar/tag-helper)

## Initializing the Calendar

The following example demonstrates how to define the Calendar by using the Calendar HtmlHelper.

```Razor HtmlHelper
    @(Html.Kendo().Calendar()
        .Name("calendar") // The name of the Calendar is mandatory. It specifies the "id" attribute of the Calendar.
        .Min(new DateTime(2010, 1, 1, 10, 0, 0)) // Set the min time of the Calendar.
        .Max(new DateTime(2020, 1, 1, 20, 0, 0)) // Set the min date of the Calendar.
        .Value(DateTime.Now) // Set the value of the Calendar.
    )
```

```Razor TagHelper
    <kendo-calendar name="calendar"
                    min="new DateTime(2010, 1, 1, 10, 0, 0)"
                    max="new DateTime(2020, 1, 1, 20, 0, 0)"
                    value="DateTime.Now">
    </kendo-calendar>
```

## Functionality and Features

* [Date ranges](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/scheduling/calendar/date-ranges)—You can set a predefined selection range.
* [Day template](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/scheduling/calendar/day-template)—The Calendar enables you to customize the rendered day for the `month` view.
* [Week numbers](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/scheduling/calendar/week-numbers)
* [Selection](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/scheduling/calendar/selection)
* [Disabled dates](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/scheduling/calendar/disabled-dates)—The Calendar allows you to disable certain days which are not intended to be selected by the end user such as weekends, national holidays, and others.
* [Accessibility](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/scheduling/calendar/accessibility/overview)—You can take advantage of the accessibility capabilities provided by the Calendar component.
* [Century cells format](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/scheduling/calendar/century-cells-format)—The component exposes two formats for the century cells.
* [Reverse selection](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/scheduling/calendar/reverse-selection)—The component allows you to pick an end date which is before the start date.
* [Show other month days](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/scheduling/calendar/show-other-month-days)—The component allows you to control if the days from the previous/next months will be displayed.

## Events

You can subscribe to all Calendar events. For a complete example on basic Calendar events, refer to the [demo on using the events of the Calendar](https://demos.telerik.com/aspnet-core/calendar/events).

### Handling by Handler Name

The following example demonstrates how to subscribe to events by a handler name.

```Razor HtmlHelper
    @(Html.Kendo().Calendar()
      .Name("calendar")
      .Events(e => e
          .Change("calendar_change")
          .Navigate("calendar_navigate")
      )
    )
    <script>
        function calendar_navigate(e) {
            // Handle the navigate event.
            var calendar = e.sender;
        }

        function calendar_change(e) {
            // Alerts the selected date with kendo.alert().
            var calendar = e.sender;
            kendo.alert(calendar.value());
        }
    </script>
```

```Razor TagHelper
   <kendo-calendar name="calendar"
                   on-change="calendar_change"
                   on-navigate="calendar_navigate">
   </kendo-calendar>
   <script>
        function calendar_navigate(e) {
            // Handle the navigate event.
            var calendar = e.sender;
        }

        function calendar_change(e) {
            // Alerts the selected date with kendo.alert().
            var calendar = e.sender;
            kendo.alert(calendar.value());
        }
    </script>
```

### Handling by Template Delegate

The following example demonstrates how to subscribe to events by a template delegate.

```Razor HtmlHelper
    @(Html.Kendo().Calendar()
      .Name("calendar")
      .Events(e => e
          .Change(@<text>
            function(e) {
              // Handle the change event inline.
              console.log(e.sender.value());
            }
          </text>)
          .Navigate(@<text>
            function(e) {
              // Handle the navigate event inline.
              console.log(e.sender);
            }
            </text>)
      )
    )
```

```Razor TagHelper
    <kendo-calendar name="calendar"
                    on-change='function(e)
                    {
                        // Handle the change event inline.
                        console.log(e.sender.value());
                    }'
                    on-navigate='function(e)
                    {
                        // Handle the navigate event inline.
                        console.log(e.sender);
                    }'>
    </kendo-calendar>
```

## Referencing Existing Instances

To reference an existing Telerik UI Calendar instance, use the [`jQuery.data()`](https://api.jquery.com/jQuery.data/) configuration option. Once a reference is established, use the [Calendar client-side API](https://docs.telerik.com/kendo-ui/api/ui/calendar#methods) to control its behavior.

```
    // Place the following after your Telerik UI Calendar for ASP.NET Core declaration.
    <script>
         $(function() {
            // The Name() of the Calendar is used to get its client-side instance.
            var calendar = $("#calendar").data("kendoCalendar");
         });
    </script>
```

## Next Steps

* [Getting Started with the Calendar](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/scheduling/calendar/getting-started)

* [Basic Usage of the Calendar for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/calendar/index)

* [Calendar in Razor Pages](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/scheduling/calendar/razor-page)

## See Also

* [Using the API of the Calendar (Demo)](https://demos.telerik.com/aspnet-core/calendar/api)
* [Knowledge Base Section](https://www.telerik.com/aspnet-core-ui/documentation/knowledge-base)
