Edit this page

DatePicker HtmlHelper Overview

The DatePicker HtmlHelper extension is a server-side wrapper for the Kendo UI DatePicker widget.

Configuration

Below are listed the steps for you to follow when configuring the Kendo UI DatePicker.

  1. Make sure you followed all the steps from the introductory article on Telerik UI for ASP.NET MVC.

  2. Create a new action method which renders the view.

    Example
        public ActionResult Index()
        {
            return View();
        }
    
  3. Add a DatePicker.

    Example
    
            <%: Html.Kendo().DatePicker()
                .Name("datepicker") //The name of the DatePicker is mandatory. It specifies the "id" attribute of the widget.
                .Min(new DateTime(1900, 1, 1)) //Set the min date of the DatePicker.
                .Max(new DateTime(2099, 12, 31)) //Set the min date of the DatePicker.
                .Value(DateTime.Today) //Set the value of the DatePicker.
            %>
    
    
            @(Html.Kendo().DatePicker()
                .Name("datepicker") //The name of the DatePicker is mandatory. It specifies the "id" attribute of the widget.
                .Min(new DateTime(1900, 1, 1)) //Set the min date of the DatePicker.
                .Max(new DateTime(2099, 12, 31)) //Set the min date of the DatePicker.
                .Value(DateTime.Today) //Set the value of the DatePicker.
            )
    

Event Handling

You can subscribe to all DatePicker events.

By Handler Name

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

Example

        <%: Html.Kendo().DatePicker()
            .Name("datepicker")
            .Events(e => e
                .Open("datepicker_open")
                .Close("datepicker_close")
                .Change("datepicker_change")
            )
        %>
        <script>
        function datepicker_open() {
            //Handle the open event
        }

        function datepicker_close() {
            //Handle the close event
        }

        function datepicker_change() {
            //Handle the change event
        }
        </script>

        @(Html.Kendo().DatePicker()
          .Name("datepicker")
          .Events(e => e
                .Open("datepicker_open")
                .Close("datepicker_close")
                .Change("datepicker_change")
          )
        )
        <script>
        function datepicker_open() {
            //Handle the open event
        }

        function datepicker_close() {
            //Handle the close event
        }

        function datepicker_change() {
            //Handle the change event
        }
        </script>

By Template Delegate

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

Example

    @(Html.Kendo().DatePicker()
      .Name("datepicker")
      .Events(e => e
          .Open(@<text>
            function() {
                //Handle the open event inline.
            }
          </text>)
          .Change(@<text>
            function() {
                //Handle the change event inline.
            }
            </text>)
      )
    )

Reference

Existing Instances

To reference an existing Kendo UI DatePicker instance, use the jQuery.data() method and use the DatePicker API to control its behavior.

Example
    // Put this after your Kendo UIDatePicker for ASP.NET MVC declaration.
    <script>
    $(function() {
        // Notice that the Name() of the DatePicker is used to get its client-side instance.
        var datepicker = $("#datepicker").data("kendoDatePicker");
    });
    </script>

See Also