The DateTimePicker control is used to allow the user to select a date and time, and to display that date and time in the specified format. You can limit the dates and times that can be selected by setting the MinDate and MaxDate properties.
You can change the look of the calendar portion of the control by setting the CalendarForeColor, CalendarFont, CalendarTitleBackColor, CalendarTitleForeColor, CalendarTrailingForeColor, and CalendarMonthBackground properties.
The Format property sets the DateTimePickerFormat of the control. The default date Format is DateTimePickerFormat..::.Long. If the Format property is set to DateTimePickerFormat..::.Custom, you can create your own format style by setting the CustomFormat property and building a custom format string. The custom format string can be a combination of custom field characters and other literal characters. For example, you can display the date as "June 01, 2001 - Friday" by setting the CustomFormat property to "MMMM dd, yyyy - dddd". For more information, see Date and Time Format Strings.
To use a spin button control (also known as an up-down control) to adjust the date/time value, set the ShowUpDown property to true. The calendar control will not drop down when the control is selected. The date and time can be adjusted by selecting each element individually and using the up and down buttons to change the value.
You might consider using a DateTimePicker control instead of a MonthCalendar if you need custom date formatting (for example, limiting a selection to just one date). Using the DateTimePicker will limit the need for much data validation of date/time values.
Note: |
|---|
The
DateTimePicker control only supports Gregorian calendars.
|
Caution: |
|---|
When a
DateTimePicker is data-bound and the backing value is changed to nullNothingnullptra null reference (Nothing in Visual Basic), the value of the DateTimePicker will not be updated and the previous value will be retained. In situations where this behavior is not desirable (for example, when using a set of data-bound controls to page through a recordset) use the Format event of the Binding class to set the DateTimePicker to a value recognizable as a nullNothingnullptra null reference (Nothing in Visual Basic).
|