DatePicker.Date Property

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Gets or sets the date currently set in the date picker.

public:
 property DateTime Date { DateTime get(); void set(DateTime value); };

DateTime Date();

void Date(DateTime value);

public System.DateTimeOffset Date { get; set; }

var dateTime = datePicker.date;
datePicker.date = dateTime;

Public Property Date As DateTimeOffset

Property Value

DateTime DateTimeOffset

The date currently set in the picker.

Examples

This example demonstrates setting the Date property in code.

<DatePicker x:Name="myDatePicker"/>

public MainPage()
{
    this.InitializeComponent();
    myDatePicker.Date = new DateTimeOffset(new DateTime(1950, 1, 1));
}

Remarks

The date picker control has both Date and SelectedDate properties. The difference between these is that Date is not nullable, while SelectedDate is nullable.

The value of SelectedDate is used to populate the date picker and is null by default. If SelectedDate is null, the Date property is set to 12/31/1600; otherwise, the Date value is synchronized with the SelectedDate value. When SelectedDate is null, the picker is 'unset' and shows the field names instead of a date.

To use the Date value in your app, you typically use a data binding to the Date property, or handle the DateChanged event.

The Date property can't be set as a XAML attribute string, because the Windows Runtime XAML parser doesn't have a conversion logic for converting strings to dates as DateTime / DateTimeOffset objects. Here are some suggested ways these objects can be defined in code and set to a date other than the current date.

• DateTime: Instantiate a Windows.Globalization.Calendar object (it is initialized to the current date). Set properties such as Day or Year, or call methods such as AddMonths, to adjust the date. Then, call Calendar.GetDateTime and use the returned DateTime to set Date.
• DateTimeOffset: Call the constructor. For the inner System.DateTime, use the constructor signature. Or, construct a default DateTimeOffset (it is initialized to the current date) and call methods such as AddMonths.

Another possible technique is to define a date that's available as a data object or in the data context, then set Date as a XAML attribute that references a {Binding} markup extension that can access the date as data.

See also

• DateChanged
• Date picker