DatePicker.Date 屬性

定義

命名空間:

Microsoft.UI.Xaml.Controls

取得或設定目前在日期選擇器中設定的日期。

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

屬性值

DateTime DateTimeOffset

目前在選擇器中設定的日期。

範例

此範例示範如何在 Date 程式代碼中設定 屬性。

<DatePicker x:Name="myDatePicker"/>

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

備註

日期選擇器控件同時 Date 具有 和 SelectedDate 屬性。 這兩者之間的差異是 Date 不可為 Null，而 SelectedDate 可為 Null。

的值 SelectedDate 是用來填入日期選擇器，且預設為 null 。 如果 SelectedDate 為 null，則 Date 屬性會設定為 12/31/1600，否則值 Date 會與 SelectedDate 值同步處理。 當 為 null時SelectedDate，選擇器為 'unset'，並顯示功能變數名稱而非日期。

若要在應用程式中使用 Date 值，您通常會使用 Date 屬性的數據 系結，或處理 DateChanged 事件。

Date屬性無法設定為 XAML 屬性字串，因為 Windows 執行階段 XAML 剖析器沒有將字串轉換成日期的轉換邏輯做為 DateTime / DateTimeOffset 物件。 以下是可在程式代碼中定義這些物件並設定為目前日期以外的日期的一些建議方式。

• DateTime：將 Windows.Globalization.Calendar 物件具現化 (初始化為目前日期) 。 設定 Day 或 Year 等屬性，或呼叫 AddMonths 之類的方法，以調整日期。 然後，呼叫 Calendar.GetDateTime 並使用傳回的 DateTime 來設定 Date。
• DateTimeOffset：呼叫建構函式。 針對內部 System.DateTime，請使用建構函式簽章。 或者，建構預設 DateTimeOffset (它會初始化為目前的日期) ，並呼叫 AddMonths 之類的方法。

另一個可能的技巧是定義可用為數據對象或數據內容中的日期，然後設定 Date 為 XAML 屬性，參考可存取日期為數據的 {Binding} 標記延伸 。

另請參閱

• DateChanged
• 日期選擇器