Compartilhar via


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

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

A propriedade Value retorna uma estrutura DateTime como seu valor. Há várias propriedades da estrutura DateTime 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 definir o valor de data e hora do controle

  • Defina a propriedade Value 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 propriedade Text para retornar todo o valor conforme formatado no controle ou chame o método apropriado da propriedade Value 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