DatePicker.MaxYear 屬性

定義

命名空間:

Microsoft.UI.Xaml.Controls

取得或設定可用於挑選的公曆年上限。

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

DateTime MaxYear();

void MaxYear(DateTime value);

public System.DateTimeOffset MaxYear { get; set; }

var dateTime = datePicker.maxYear;
datePicker.maxYear = dateTime;

Public Property MaxYear As DateTimeOffset

屬性值

DateTime DateTimeOffset

可供挑選的公曆年份上限。

範例

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

<DatePicker x:Name="myDatePicker"/>

public MainPage()
{
    this.InitializeComponent();
    myDatePicker.MinYear = new DateTimeOffset(new DateTime(1950, 1, 1));
    myDatePicker.MaxYear = DateTimeOffset.Now.AddYears(5);
}

備註

您可以設定 MinYear 和 MaxYear 屬性，以限制選擇器中的日期值。 根據預設， MinYear 會設定為目前日期之前的 100 年，且 MaxYear 設定為 100 年超過目前日期。

如果您只 MinYear 設定 或 MaxYear，則必須確定有效的日期範圍是由您設定的日期以及另一個日期的預設值所建立;否則，選擇器中將無法選取任何日期。 例如，設定只會 yearDatePicker.MaxYear = new DateTimeOffset(new DateTime(900, 1, 1)); 建立預設值為 的 MinYear無效日期範圍。

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

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

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

另請參閱

• MinYear
• 日期選擇器