aspnet-11649-components-data-editors-calendar.md
The ASPxCalendar control allows end users to select dates and navigate through months and years.
End users can work in single or multiple date selection mode (the EnableMultiSelect property). In multiple date selection mode, users can select individual dates or a range of dates. To choose a range of dates, select the initial date and hold the left mouse button (or the Shift key) down while moving the mouse to the final date. Hold down the Ctrl key to add a date to or remove it from the selection. Click a week number to select the entire week.
The HighlightToday and HighlightWeekends properties allow you to highlight today’s date and weekend days.
The following table lists API members you can use to customize the Calendar’s appearance:
| Element | Visibility | Appearance |
|---|---|---|
| Today Button | ShowTodayButton | ButtonStyle |
| Clear Button | ShowClearButton | ButtonStyle |
| Week Numbers | ShowWeekNumbers | WeekNumberStyle |
| Day Headers | ShowDayHeaders | DayHeaderStyle |
| Header | ShowHeader | HeaderStyle |
| Month Navigation Buttons | EnablePeriodNavigation | NextPeriodImage, PrevPeriodImage |
| Year Navigation Buttons | EnableLargePeriodNavigation | NextLargePeriodImage, PrevLargePeriodImage |
The Calendar control can display multiple months and organize them in several rows and columns. The Columns and Rows properties allow you to define the number of columns and rows.
The Month-year Picker mode allows you to specify which date component an end user can select: a day, a month or a year. You can click the header to change the calendar view (fast navigation). Use the following settings to specify how users select dates and restrict the available calendar views:
| Property | Description |
|---|---|
| PickerType | Specifies a date component an end user can select (a day, month or year). |
| InitialView | Specifies the initial Calendar view. |
| MaxView | Specifies the earliest available Calendar view. For example, if the MaxView property is set to Months, the picker displays the months of a particular year and January is the earliest available Calendar view item. |
The Calendar can display the fast navigation panel in the editor or popup window (the DisplayMode property).
You can customize each calendar day’s appearance before the browser renders a page.
Run Demo: Custom Day Rendering
The Calendar control allows you to validate data on the client and server sides. Refer to the following topic for more information: Validation.
The ASPxClientCalendar object is the client-side equivalent of the ASPxCalendar control. This object exposes the control’s comprehensive client-side API.
| Method | Description |
|---|---|
| ClearSelection | Deselects all selected dates. |
| DeselectDate(date) | Deselects the specified date. |
| DeselectRange(start, end) | Deselects the range of dates. |
| GetMaxDate | Gets the earliest date a user can select. |
| GetMinDate | Gets the furthest date a user can select. |
| GetSelectedDate | Returns the selected date. |
| SetSelectedDate(date) | Sets the calendar’s selected date. |
| GetSelectedDates | Gets a list of selected dates. |
| GetVisibleDate | Gets the date (day, month, year) that the calendar displays. |
| IsDateSelected(date) | Specifies whether the specified date is selected. |
| SelectDate(date) | Selects the specified date. |
| SelectRange(start, end) | Selects the specified range of dates. |
| SetMaxDate(date) | Sets the calendar’s furthest date an end user can select. |
| SetMinDate(date) | Sets the calendar’s earliest date an end user can select. |
| SetSelectedDate(date) | Sets the calendar’s selected date. |
| SetVisibleDate(date) | Sets the date (day, month, year) the calendar displays. |