DateTimePicker.CustomFormat DateTimePicker.CustomFormat DateTimePicker.CustomFormat DateTimePicker.CustomFormat Property

Définition

Obtient ou définit la chaîne de format de date/heure personnalisé.Gets or sets the custom date/time format string.

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

Valeur de propriété

Chaîne représentant le format de date/heure personnalisé.A string that represents the custom date/time format. La valeur par défaut est null.The default is null.

Exemples

L’exemple de code suivant définit CustomFormat la propriété de sorte DateTimePicker que le affiche la date sous la forme « juin 01, 2001-Friday ».The following code example sets the CustomFormat property so that the DateTimePicker will display the date as "June 01, 2001 - Friday". Ce code suppose qu’une instance d’un DateTimePicker contrôle a été créée sur un. FormThis code assumes that an instance of a DateTimePicker control has been created on a 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 contenant des séparateurs de date et d’heure ou des chaînes de format, vous devez utiliser des caractères d’échappement dans la sous-chaîne.To display string literals that contain date and time separators or to format strings, you must use escape characters in the substring. Par exemple, pour afficher la date au format « 15 juin à 12:00 PM », affectez à la propriété la valeur « mmmm DD » à l' CustomFormat adresse « t :mm TT ».For example, to display the date as "June 15 at 12:00 PM", set the CustomFormat property to "MMMM dd 'at' t:mm tt". Si la sous-chaîne « at » n’est pas encadrée par des caractères d’échappement, le résultat est « 15 juin aP 12:14:00 », car le caractère « t » est lu comme suit :If the "at" substring is not enclosed by escape characters, the result is "June 15 aP 12:00PM" because the "t" character is read as the one-letter A.M./P.M. chaîne de format (consultez le tableau de chaînes de format ci-dessous).format string (see the format string table below).

Les chaînes de format peuvent être combinées pour mettre en forme la date et l’heure.The format strings can be combined to format the date and time. Par exemple, pour afficher la date et l’heure sous la forme 06/15/2001 12:00 PM, cette propriété doit être définie sur « MM »/« JJ »/« yyyy hh » : « mm TT ».For example, to display the date and time as 06/15/2001 12:00 PM, this property should be set to "MM'/'dd'/'yyyy hh':'mm tt". Pour plus d’informations, consultez chaînes de format de date et d’heure personnalisées.For more information, see Custom Date and Time Format Strings.

Notes

La Format propriété doit avoir la DateTimePickerFormat.Custom valeur pour que cette propriété affecte la mise en forme de la date et de l’heure affichées.The Format property must be set to DateTimePickerFormat.Custom for this property to affect the formatting of the displayed date and time.

Le tableau suivant répertorie toutes les chaînes de format valides et leurs descriptions.The following table lists all the valid format strings and their descriptions.

Chaîne de mise en formeFormat string DescriptionDescription
dd Jour à un ou deux chiffres.The one- or two-digit day.
dddd Jour à deux chiffres.The two-digit day. Les valeurs de jour à un seul chiffre sont précédées d’un 0.Single-digit day values are preceded by a 0.
dddddd Abréviation de jour de semaine à trois caractères.The three-character day-of-week abbreviation.
dddddddd Nom complet du jour de la semaine.The full day-of-week name.
hh Heure à une ou deux chiffres au format 12 heures.The one- or two-digit hour in 12-hour format.
hhhh Heure à deux chiffres au format 12 heures.The two-digit hour in 12-hour format. Les valeurs à un seul chiffre sont précédées d’un 0.Single digit values are preceded by a 0.
HH Heure à une ou deux chiffres au format 24 heures.The one- or two-digit hour in 24-hour format.
HHHH Heure à deux chiffres au format 24 heures.The two-digit hour in 24-hour format. Les valeurs à un seul chiffre sont précédées d’un 0.Single digit values are preceded by a 0.
mm Minute à un ou deux chiffres.The one- or two-digit minute.
mmmm Minute à deux chiffres.The two-digit minute. Les valeurs à un seul chiffre sont précédées d’un 0.Single digit values are preceded by a 0.
MM Numéro de mois à une ou deux chiffres.The one- or two-digit month number.
MMMM Numéro de mois à deux chiffres.The two-digit month number. Les valeurs à un seul chiffre sont précédées d’un 0.Single digit values are preceded by a 0.
MMMMMM Abréviation de trois caractères du mois.The three-character month abbreviation.
MMMMMMMM Nom complet du mois.The full month name.
ss Secondes à un ou deux chiffres.The one- or two-digit seconds.
ssss Secondes à deux chiffres.The two-digit seconds. Les valeurs à un seul chiffre sont précédées d’un 0.Single digit values are preceded by a 0.
tt Une lettre de AM-PMThe one-letter A.M./P.M. abréviation (A.M.abbreviation (A.M. s’affiche en tant que « A »).is displayed as "A").
tttt Les deux lettres AM/PMThe two-letter A.M./P.M. abréviation (A.M.abbreviation (A.M. s’affiche en tant que « AM »).is displayed as "AM").
oy L’année à un chiffre (2001 est affichée sous la forme « 1 »).The one-digit year (2001 is displayed as "1").
yyyy Les deux derniers chiffres de l’année (2001 s’affichent sous la forme « 01 »).The last two digits of the year (2001 is displayed as "01").
yyyyyyyy L’année complète (2001 est affichée sous la forme « 2001 »).The full year (2001 is displayed as "2001").

S’applique à

Voir aussi