# Getting Started with the DateRangePicker

This tutorial explains how to set up a basic Telerik UI for ASP.NET MVC DateRangePicker and highlights the major steps in the configuration of the component.

You will initialize a DateRangePicker control with a number of tools. Next, you will handle some of the DateRangePicker events.

![Sample Telerik UI for ASP.NET MVC DateRangePicker](https://www.telerik.com/aspnet-mvc/documentation/assets/5cf6d24e361e2ab64678884dea16bada/daterangepicker-getting-started.png)

## Prerequisites

To successfully complete the tutorial, you need a project that is already configured to use the Telerik UI for ASP.NET MVC components:

* To create a new pre-configured project for the Telerik UI for ASP.NET MVC components, you can [use a project template](https://www.telerik.com/aspnet-mvc/documentation/getting-started-mvc/first-steps).

* To manually configure an existing project by using NuGet, see the [Adding Telerik UI through NuGet](https://www.telerik.com/aspnet-mvc/documentation/getting-started/setup-with-nuget).

## 1. Prepare the CSHTML File

The first step is to add the required directives at the top of the `.cshtml` document:

* To use the Telerik UI for ASP.NET MVC HtmlHelpers:

  ```cshtml
  @using Kendo.Mvc.UI
  ```

Optionally, you can structure the document by adding the desired HTML elements like headings, divs, paragraphs, and apply some basic styles.

## 2. Initialize the DateRangePicker

Use the DateRangePicker HtmlHelper  to add the component to a page:

* The `Name()` configuration method is mandatory as its value is used for the `id` and the `name` attributes of the DateRangePicker element.

* The `Culture()` configuration method specifies the culture info used by the widget. `Date` and `time` values typically vary by culture. For example, the `"d"` standard format string indicates that a date and time value is to be displayed using a short date pattern. For the invariant culture, this pattern is `"MM/dd/yyyy"`. For the `fr-FR` culture, it is `"dd/MM/yyyy"`. For the `ja-JP` culture, it is `"yyyy/MM/dd"`.

* The `Labels` configuration method determines if the labels for the inputs will be visible.

```Razor HtmlHelper

@using Kendo.Mvc.UI

@(Html.Kendo().DateRangePicker()
            .Name("daterangepicker")
            .Culture("fr-FR")
            .Labels(true)
        )
```

## 3. Handle the DateRangePicker Events

The DateRangePicker [exposes various events](https://www.telerik.com/aspnet-mvc/documentation/api/kendo.mvc.ui.fluent/daterangepickereventbuilder) that you can handle and further customize the functionality of the component. In this tutorial, you will use the `Open`, `Close`, and `Change` events of the DateRangePicker.

```Razor HtmlHelper
@using Kendo.Mvc.UI

@(Html.Kendo().DateRangePicker()
          .Name("daterangepicker")
          .Culture("fr-FR")
          .Labels(true)
          .Events(e=> e.Open("onOpen").Close("onClose").Change("onChange"))
        )

<script>
        function onOpen() {
            console.log("Open");
        }

        function onClose() {
            console.log("Close");
        }

        function onChange() {
            var range = this.range();
            console.log("Change :: start - " + kendo.toString(range.start, 'd') + " end - " + kendo.toString(range.end, 'd'));
        }
</script>
```

For more examples, refer to the [demo on using the events of the DateRangePicker](https://demos.telerik.com/aspnet-mvc/daterangepicker/events).

## 4. (Optional) Reference Existing DateRangePicker Instances

To use the [client-side API of the DateRangePicker](https://docs.telerik.com/kendo-ui/api/ui/daterangepicker) and build on top of its initial configuration, you need a reference to the DateRangePicker instance. Once you get a valid reference, you can call the respective API methods:

1. Use the `.Name()` (`id` attribute) of the component instance to get a reference.

   ```JS script
       <script>
           var dateRangePickerReference = $("#daterangepicker").data("kendoDateRangePicker"); // DateRangePicker Reference is a reference to the existing instance of the helper.
       </script>
   ```

2. Use the [client-side API of the DateRangePicker](https://docs.telerik.com/kendo-ui/api/ui/daterangepicker) to control the behavior of the widget. In this example, you will use the [`enable`](https://docs.telerik.com/kendo-ui/api/ui/daterangepicker/methods/enable) method to disable the DateRangePicker.

   ```JS script
       <script>
           $(document).ready(function () {
               var daterangepicker = $("#daterangepicker").data("kendoDateRangePicker");

               daterangepicker.enable(false);
           })
       </script>
   ```

For more information on referencing specific helper instances, see the [Methods and Events](https://www.telerik.com/aspnet-mvc/documentation/html-helpers/helper-basics/events-and-methods) article.

## Next Steps

* [Configuring the Selected Dates of the DateRangePicker ](https://www.telerik.com/aspnet-mvc/documentation/html-helpers/editors/daterangepicker/selected-dates)
* [Changing the Appearance of the DateRangePicker](https://www.telerik.com/aspnet-mvc/documentation/html-helpers/editors/daterangepicker/appearance)
* [Using Validation with the DateRangePicker](https://www.telerik.com/aspnet-mvc/documentation/html-helpers/editors/daterangepicker/validation)

## See Also

* [Using the API of the DateRangePicker for ASP.NET MVC (Demo)](https://demos.telerik.com/aspnet-mvc/daterangepicker/api)
* [Client-Side API of the DateRangePicker](https://docs.telerik.com/kendo-ui/api/ui/daterangepicker)
* [Server-Side API of the DateRangePicker](https://www.telerik.com/aspnet-mvc/documentation/api/daterangepicker)
* [Knowledge Base Section](https://www.telerik.com/aspnet-mvc/documentation/knowledge-base)
