Como definir e retornar datas com o controle DateTimePicker dos Windows Forms

A data ou hora atualmente selecionada no controle Windows Forms DateTimePicker é determinada pela Value propriedade. Você pode definir a Value propriedade antes que o controle seja exibido (por exemplo, em tempo de design ou no evento do Load formulário) para determinar qual data será inicialmente selecionada no controle. Por padrão, o controle Value é definido para a data atual. Se você alterar o código do Value controle, o controle será atualizado automaticamente no formulário para refletir a nova configuração.

A Value propriedade retorna uma DateTime estrutura como seu valor. Há várias propriedades da DateTime estrutura que retornam informações específicas sobre a data exibida. Essas propriedades só podem ser usadas para retornar um valor; não as utilize para definir um valor.

• Para valores de data, as propriedades , Daye Year e Monthretornam valores inteiros para essas unidades de tempo da data selecionada. A DayOfWeek propriedade retorna um valor que indica o dia da semana selecionado (os valores possíveis são listados na DayOfWeek enumeração).

• Para valores de tempo, as Hourpropriedades , Minute, Seconde e Millisecond retornam valores inteiros para essas unidades de tempo. Para configurar o controle para exibir horas, consulte Como exibir a hora com o controle DateTimePicker.

Definir o valor de data e hora do controle

• Defina a Value propriedade como um valor de data ou hora.

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

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

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

Retornar o valor de data e hora

• Chame a propriedade para retornar o valor inteiro como formatado no controle ou chame Text o método apropriado da Value propriedade para retornar uma parte do valor. Use ToString para converter as informações em uma cadeia de caracteres que pode ser exibida para o usuário.

  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()));  
  

Confira também

• Controle DateTimePicker
• Como exibir uma data em um formato personalizado com o controle DateTimePicker dos Windows Forms