DateTimePicker.CustomFormat Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DateTimePicker.cs

Ottiene o imposta la stringa di formato di data/ora personalizzata.

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

Valore della proprietà

String

Stringa che rappresenta il formato di data/ora personalizzato. Il valore predefinito è null.

Esempio

Nell'esempio di codice seguente la CustomFormat proprietà viene impostata in modo che la DateTimePicker data venga visualizzata come "01 giugno 2001 - Venerdì". Questo codice presuppone che un'istanza di un DateTimePicker controllo sia stata creata in un oggetto 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

Commenti

Per visualizzare valori letterali stringa che contengono separatori di data e ora o per formattare le stringhe, è necessario usare caratteri di escape nella sottostringa. Ad esempio, per visualizzare la data come "15 giugno alle 12:00 PM", impostare la CustomFormat proprietà su "MMMM dd 'at' t:mm tt". Se la sottostringa "at" non è racchiusa tra caratteri di escape, il risultato è "15 giugno aP 12:00PM" perché il carattere "t" viene letto come stringa di formato una lettera A.M./P.M. (vedere la tabella delle stringhe di formato riportata di seguito).

Le stringhe di formato possono essere combinate per formattare la data e l'ora. Ad esempio, per visualizzare la data e l'ora come 06/15/2001 12:00 PM, questa proprietà deve essere impostata su "MM'/'dd'/'aaa hh':'mm tt". Per altre informazioni, vedere Stringhe di formato di data e ora personalizzate.

Annotazioni

La Format proprietà deve essere impostata su per consentire a DateTimePickerFormat.Custom questa proprietà di influire sulla formattazione della data e dell'ora visualizzate.

Nella tabella seguente sono elencate tutte le stringhe di formato valide e le relative descrizioni.

Stringa di formato	Descrizione
d	Giorno di una o due cifre.
dd	Giorno a due cifre. I valori dei giorni a una cifra singola sono preceduti da un valore 0.
Ddd	Abbreviazione di tre caratteri di giorno della settimana.
dddd	Nome completo della settimana.
h	Ora a una o due cifre in formato 12 ore.
hh	Ora a due cifre in formato 12 ore. I valori a cifra singola sono preceduti da un valore 0.
H	Ora a una o due cifre in formato 24 ore.
HH	Ora a due cifre in formato 24 ore. I valori a cifra singola sono preceduti da un valore 0.
m	Minuto di una o due cifre.
millimetro	Minuto a due cifre. I valori a cifra singola sono preceduti da un valore 0.
M	Numero di mese uno o due cifre.
MILLIMETRO	Numero mese a due cifre. I valori a cifra singola sono preceduti da un valore 0.
MMM	Abbreviazione del mese a tre caratteri.
MMMM	Nome completo del mese.
s	Secondi uno o due cifre.
ss	Secondi a due cifre. I valori a cifra singola sono preceduti da un valore 0.
t	Abbreviazione di una lettera A.M./P.M. (M.M. viene visualizzata come "A").
tt	Abbreviazione A.M./P.M. a due lettere (M.M. viene visualizzata come "AM").
y	L'anno a una cifra (2001 viene visualizzato come "1").
yy	Le ultime due cifre dell'anno (2001 viene visualizzato come "01").
yyyy	L'anno completo (2001 viene visualizzato come "2001").

Vedi anche

• DateTimePickerFormat
• Format