Partager via


Guide pour définir et retourner des dates avec le contrôle Windows Forms DateTimePicker

La date ou l’heure actuellement sélectionnée dans le contrôle DateTimePicker Windows Forms est déterminée par la propriété Value. Vous pouvez définir la propriété Value avant l’affichage du contrôle (par exemple, au moment du design ou dans l’événement de Load du formulaire) pour déterminer la date initialement sélectionnée dans le contrôle. Par défaut, la Value du contrôle est définie sur la date actuelle. Si vous modifiez la Value du contrôle dans le code, le contrôle est automatiquement mis à jour sur le formulaire pour refléter le nouveau paramètre.

La propriété Value retourne une structure DateTime comme valeur. Il existe plusieurs propriétés de la structure DateTime qui retournent des informations spécifiques sur la date affichée. Ces propriétés ne peuvent être utilisées que pour retourner une valeur ; ne les utilisez pas pour définir une valeur.

  • Pour les valeurs de date, les propriétés Month, Dayet Year retournent des valeurs entières pour ces unités de temps de la date sélectionnée. La propriété DayOfWeek retourne une valeur indiquant le jour sélectionné de la semaine (les valeurs possibles sont répertoriées dans l’énumération DayOfWeek).

  • Pour les valeurs temporelles, les propriétés Hour, Minute, Secondet Millisecond retournent des valeurs entières pour ces unités de temps. Pour configurer le contrôle pour afficher les heures d’affichage, consultez How to : Display Time with the DateTimePicker Control.

Pour définir la valeur de date et d’heure du contrôle

  • Définissez la propriété Value sur une valeur de date ou d’heure.

    DateTimePicker1.Value = New DateTime(2001, 10, 20)  
    
    dateTimePicker1.Value = new DateTime(2001, 10, 20);  
    
    dateTimePicker1->Value = DateTime(2001, 10, 20);  
    

Pour retourner la valeur de date et d’heure

  • Appelez la propriété Text pour renvoyer la valeur entière comme mise en forme dans le contrôle, ou appelez la méthode appropriée de la propriété Value pour retourner une partie de la valeur. Utilisez ToString pour convertir les informations en chaîne qui peuvent être affichées à l’utilisateur.

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

Voir aussi