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

A data ou hora atualmente selecionada no controle dos Windows Forms DateTimePicker é determinada pela Value propriedade. Você pode definir a propriedade Value antes que o controle seja exibido (por exemplo, em tempo de projeto ou no evento Load do formulário) para determinar qual data será inicialmente selecionada no controle. Por padrão, o controle Value é definido como a data atual. Se você alterar o controle Value no código, 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 os use para definir um valor.

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

• Para valores de tempo, as propriedades Hour, Minute, Second e Millisecond retornam valores inteiros para essas unidades de tempo. Para configurar o controle para exibir horários, consulte Como exibir a hora com o controle DateTimePicker.

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

Para retornar o valor de data e hora

• Chame a Text propriedade para retornar todo o valor conforme formatado no controle ou chame 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()));
  

Consulte também

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