Comment : définir et retourner des dates à l'aide du contrôle DateTimePicker Windows Forms

Mise à jour : novembre 2007

La date ou l'heure actuelle 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 d'afficher le contrôle (par exemple, au moment du design ou dans l'événement Load du formulaire) pour déterminer la première date sélectionnée dans le contrôle. Par défaut, la propriété Value du contrôle prend pour valeur la date en cours. Si vous changez sa propriété Value dans le code, le contrôle est automatiquement mis à jour dans le formulaire pour rendre compte du nouveau paramètre.

La propriété Value retourne comme valeur une structure DateTime. Plusieurs propriétés de la structure DateTime retournent des informations particulières sur la date affichée. Ces propriétés peuvent être utilisées uniquement pour retourner une valeur ; ne les utilisez pas pour définir une valeur.

  • En ce qui concerne les valeurs de date, les propriétés Month, Day et Year retournent des valeurs entières par défaut pour les unités de temps de la date sélectionnée. La propriété DayOfWeek retourne une valeur indiquant le jour de la semaine sélectionné (la liste des valeurs possibles est fournie dans l'énumération DayOfWeek).

  • Pour les valeurs d'heure, les propriétés Hour, Minute, Second et Millisecond retournent des valeurs entières pour ces unités de temps.

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

  • Affectez à la propriété Value une valeur de date ou d'heure.

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

Pour retourner une valeur de date et d'heure

  • Appelez la propriété Text pour retourner la valeur intégrale, au format qui est le sien dans le contrôle, ou la méthode appropriée de la propriété Value pour retourner une partie de cette valeur. Utilisez ToString pour convertir les informations en une chaîne pouvant être affichée à l'intention de 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(("The selected value is " + dateTimePicker1.get_Text()));
    MessageBox.Show(("The day of the week is " +
       dateTimePicker1.get_Value().get_DayOfWeek().ToString()));
    MessageBox.Show("Millisecond is: " + 
      Convert.ToString(dateTimePicker1.get_Value().get_Millisecond()));
    
    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

Tâches

Comment : afficher une date dans un format personnalisé à l'aide du contrôle DateTimePicker Windows Forms

Autres ressources

DateTimePicker, contrôle (Windows Forms)