如何：使用 Windows Form DateTimePicker 控制項設定和傳回日期

在 Windows Form DateTimePicker 控制項中目前選取的日期或時間取決於 Value 屬性。 您可以在顯示控制項之前 (例如，在設計階段或在表單的 Load 事件) 設定 Value 屬性來判斷在控制項中一開始所選取的日期。 根據預設，此控制項的 Value 設為目前的日期。 如果您在程式碼中變更控制項的 Value，控制項會在表單上自動更新以反映新的設定。

Value 屬性傳回 DateTime 結構做為其值。 有幾個 DateTime 結構的屬性會傳回所顯示日期的特定資訊。 這些屬性只可以用來傳回值；請勿使用這些來設定值。

• 對於日期值，MonthDay和 Year 屬性會傳回所選取日期之時間單位的整數值。 DayOfWeek 屬性會傳回值，表示所選取的是星期幾 (可能的值會列在 DayOfWeek 列舉中)。

• 對於時間值，Hour、Minute、Second 和 Millisecond 屬性會傳回時間單位的整數值。 若要設定控制項以顯示時間，請參閱 如何：使用 DateTimePicker 控制項 顯示時間。

設定控制項的日期和時間值

• 設定 Value 屬性為日期或時間值。

  DateTimePicker1.Value = New DateTime(2001, 10, 20)  
  

  dateTimePicker1.Value = new DateTime(2001, 10, 20);  
  

  dateTimePicker1->Value = DateTime(2001, 10, 20);  
  

傳回日期和時間值

• 呼叫 Text 屬性來傳回整個值為控制項中的格式，或呼叫 Value 屬性的適當方法，以傳回值的一部分。 使用 ToString 將資訊轉換成可以向使用者顯示的字串。

  MessageBox.Show("The selected value is ", DateTimePicker1.Text)  
  MessageBox.Show("The day of the week is ",
     DateTimePicker1.Value.DayOfWeek.ToString)  
  MessageBox.Show("Millisecond is: ",
     DateTimePicker1.Value.Millisecond.ToString)  
  

  MessageBox.Show ("The selected value is " +
     dateTimePicker1.Text);  
  MessageBox.Show ("The day of the week is " +
     dateTimePicker1.Value.DayOfWeek.ToString());  
  MessageBox.Show("Millisecond is: " +
     dateTimePicker1.Value.Millisecond.ToString());  
  

  MessageBox::Show (String::Concat("The selected value is ",  
     dateTimePicker1->Text));  
  MessageBox::Show (String::Concat("The day of the week is ",  
     dateTimePicker1->Value.DayOfWeek.ToString()));  
  MessageBox::Show(String::Concat("Millisecond is: ",  
     dateTimePicker1->Value.Millisecond.ToString()));  
  

另請參閱

• DateTimePicker 控制項
• 操作說明：使用 Windows Forms DateTimePicker 控制項顯示自訂格式的日期