DateTimePicker.CustomFormat Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

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 représentant 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é afin que le DateTimePicker affiche la date « 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 à 12h00 », 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 « June 15 aP 12:00PM », car le caractère « t » est lu comme chaîne de format A.M./P.M. à une lettre (voir le tableau de format chaîne 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/06/2001 à 12:00 PM, cette propriété doit être définie sur « MM'/'dd'/'yyyy hh':'mm tt ». Pour plus d’informations, consultez Chaînes de format de date et d’heure personnalisées.

Notes

La Format propriété doit être définie sur DateTimePickerFormat.Custom pour 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.
jj Jour à deux chiffres. Les valeurs de jour à un chiffre sont précédées d’un 0.
ddd Abréviation du jour de la semaine à trois caractères.
dddd Nom complet du jour de la semaine.
h Heure à un ou deux chiffres au format 12 heures.
hh Heure à deux chiffres au format 12 heures. Les valeurs à un chiffre 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 à un chiffre sont précédées d’un 0.
m Minute à un ou deux chiffres.
MM Minute à deux chiffres. Les valeurs à un chiffre 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 à un chiffre 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 à un chiffre sont précédées d’un 0.
t Abréviation d’une lettre A.M./P.M. (A.M. s’affiche sous la forme « A »).
tt Abréviation à deux lettres A.M./P.M. (A.M. s’affiche sous la forme « AM »).
o L’année à un chiffre (2001 est affichée sous la forme « 1 »).
yy Les deux derniers chiffres de l’année (2001 sont affichés sous la forme « 01 »).
aaaa L’année complète (2001 est affichée sous la forme « 2001 »).

S’applique à

Voir aussi