Skip to main content
Version: 11.0.x

DatePicker

The DatePicker has three 'spinner' controls to allow the user to pick a date value. The spinners display when the control is clicked.

Useful Properties

You will probably use these properties most often:

PropertyDescription
DayVisibleSets if the day column is visible.
MonthVisibleSets if the month column is visible.
YearVisibleSets if the year column is visible.
DayFormatFormat string for the day part of the date.
MonthFormatFormat string for the month part of the date.
YearFormatFormat string for the year part of the date.
SelectedDateThe date selected (null when no selection).

Example

This example uses the date format attribute to display the name of the day as well as the number:

<StackPanel Margin="20">
<DatePicker DayFormat="ddd dd"/>
</StackPanel>

Initializing the Date

The date properties of this control cannot be set in XAML using an attribute. This is because there is no conversion available for converting strings to date objects like DateTime and DateTimeOffset.

You will need to write code-behind like this:

datePicker.SelectedDate = new DateTimeOffset(new DateTime(1950, 1, 1));

More Information

For the complete API documentation about this control, see here.

View the source code on GitHub DatePicker.cs