Partager via

DateTimePicker.CustomFormat Propriété

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
DateTimePicker.cs
Source:
DateTimePicker.cs
Source:
DateTimePicker.cs
Source:
DateTimePicker.cs
Source:
DateTimePicker.cs

Obtient ou définit la chaîne de format de date/heure personnalisée.

public:
 property System::String ^ CustomFormat { System::String ^ get(); void set(System::String ^ value); };
public string CustomFormat { get; set; }
public string? CustomFormat { get; set; }
member this.CustomFormat : string with get, set
Public Property CustomFormat As String

Valeur de propriété

String

Chaîne qui représente le format de date/heure personnalisé. La valeur par défaut est null.

Exemples

L’exemple de code suivant définit la CustomFormat propriété de sorte que la DateTimePicker date d’affichage soit « 01 juin 2001 - Vendredi ». Ce code suppose qu’une instance d’un DateTimePicker contrôle a été créée sur un Form.

public:
   void SetMyCustomFormat()
   {
      // Set the Format type and the CustomFormat string.
      dateTimePicker1->Format = DateTimePickerFormat::Custom;
      dateTimePicker1->CustomFormat = "MMMM dd, yyyy - dddd";
   }

public void SetMyCustomFormat()
{
   // Set the Format type and the CustomFormat string.
   dateTimePicker1.Format = DateTimePickerFormat.Custom;
   dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
}

Public Sub SetMyCustomFormat()
    ' Set the Format type and the CustomFormat string.
    dateTimePicker1.Format = DateTimePickerFormat.Custom
    dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
End Sub

Remarques

Pour afficher des littéraux de chaîne qui contiennent des séparateurs de date et d’heure ou pour mettre en forme des chaînes, vous devez utiliser des caractères d’échappement dans la sous-chaîne. Par exemple, pour afficher la date « 15 juin à 12 h 00 », définissez la CustomFormat propriété sur « MMMM dd 'at' t :mm tt ». Si la sous-chaîne « at » n’est pas entourée de caractères d’échappement, le résultat est « 15 juin aP 12:00PM », car le caractère « t » est lu en tant que chaîne de format A.M./P.M. d’une lettre (voir le tableau de chaînes de format ci-dessous).

Les chaînes de format peuvent être combinées pour mettre en forme la date et l’heure. Par exemple, pour afficher la date et l’heure du 15/15/2001 12:00, cette propriété doit être définie sur « MM'/'dd'/'aaaa hh' :mm tt ». Pour plus d’informations, consultez Chaînes de format de date et d’heure personnalisées.

Note

La Format propriété doit être définie pour DateTimePickerFormat.Custom que cette propriété affecte la mise en forme de la date et de l’heure affichées.

Le tableau suivant répertorie toutes les chaînes de format valides et leurs descriptions.

Chaîne de format Description
d Jour à un ou deux chiffres.
dd Jour à deux chiffres. Les valeurs de jour à un chiffre sont précédées d’un 0.
jjj Abréviation de trois caractères jour de semaine.
dddd Nom complet de la journée de la semaine.
h Heure à un ou deux chiffres au format 12 heures.
hh Heure à deux chiffres au format 12 heures. Les valeurs à chiffres uniques sont précédées d’un 0.
H Heure à un ou deux chiffres au format 24 heures.
HH Heure à deux chiffres au format 24 heures. Les valeurs à chiffres uniques sont précédées d’un 0.
m Minute à un ou deux chiffres.
mm Minute à deux chiffres. Les valeurs à chiffres uniques sont précédées d’un 0.
M Numéro de mois à un ou deux chiffres.
MM Numéro de mois à deux chiffres. Les valeurs à chiffres uniques sont précédées d’un 0.
MMM Abréviation de mois à trois caractères.
MMMM Nom complet du mois.
s Secondes à un ou deux chiffres.
ss Secondes à deux chiffres. Les valeurs à chiffres uniques sont précédées d’un 0.
t L’abréviation d’une lettre A.M./P.M. (A.M. est affichée sous la forme « A »).
tt L’abréviation de deux lettres A.M./P.M. (A.M. est affichée sous la forme « AM »).
y L’année à un chiffre (2001 est affichée sous la forme « 1 »).
yy Les deux derniers chiffres de l’année (2001 s’affichent sous la forme « 01 »).
aaaa L’année complète (2001 s’affiche sous la forme « 2001 »).

S’applique à

Voir aussi