A newer version of this page is available. Switch to the current version.

DateEdit Class

The editor to edit date/time values using a dropdown calendar.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v18.2.dll


[ToolboxBitmap(typeof(ToolboxIconsRootNS), "DateEdit")]
public class DateEdit :
<ToolboxBitmap(GetType(ToolboxIconsRootNS), "DateEdit")>
Public Class DateEdit
    Inherits PopupBaseEdit
    Implements IDateRangeCollectionOwner


The DateEdit control allows date/time values to be entered using a dropdown calendar and edit box.


The DateEdit.Properties property (a RepositoryItemDateEdit class instance) contains the DateEdit control's various settings.

Use the RepositoryItemDateEdit.CalendarView property to choose a calendar style:

Calendar Style Description
CalendarView.Vista The Vista-style calendar:  
CalendarView.TouchUI The touch-aware date-editing UI:     For a DateEdit control, the control's mask (see the RepositoryItemTextEdit.Mask inherited property) specifies which date-time columns are displayed in the dropdown calendar. To display time columns, enable the RepositoryItemDateEdit.CalendarTimeEditing option.
CalendarView.Classic The classic calendar:    
CalendarView.ClassicNew An Outlook 2016-inspired calendar style.    

Main Settings and Events

Masked Input

By default, DateEdit functions in the DateTime masked mode, which allows you to enter date/time values using one of the standard or custom date/time patterns. Use the RepositoryItemDateEdit.EditMask property to switch from the default pattern (short date -"d") to another one.

Set the MaskProperties.MaskType (DateEdit.Properties.Mask.MaskType) property to DateTimeAdvancingCaret to allow the caret to automatically skip date separators while entering date/time values.


The date/time masks only support the following calendars: Gregorian, Korean, Taiwan, and Thai Buddhist.

Entering Date-Time Values

See the following topic to learn about the editors you can use to enter date-time values: How to: Enter date-time values.

See Also