Condividi tramite

DateTimePicker.CustomFormat Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

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

Valore della proprietà

String

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

Esempio

Nell'esempio di codice seguente viene impostata la CustomFormat proprietà in modo che venga DateTimePicker visualizzata la data 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 contenenti separatori di data e ora o per formattare 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 seguente).

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

Nota

La Format proprietà deve essere impostata su DateTimePickerFormat.Custom affinché questa proprietà influisca 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 uno o due cifre.
gg Giorno a due cifre. I valori dei giorni a cifra singola sono preceduti da un valore 0.
ddd Abbreviazione di tre caratteri giorno della settimana.
dddd Nome completo della settimana.
h Ora di 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 0.
H Ora di 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 0.
m Minuto di una o due cifre.
MM Minuto a due cifre. I valori a cifra singola sono preceduti da 0.
M Numero di mese di una o due cifre.
MM Numero mese a due cifre. I valori a cifra singola sono preceduti da 0.
MMM Abbreviazione di tre caratteri del mese.
MMMM Nome completo del mese.
s Secondi uno o due cifre.
ss Secondi a due cifre. I valori a cifra singola sono preceduti da 0.
t L'abbreviazione di una lettera A.M./P.M. (A.M. viene visualizzata come "A").
tt L'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").
aaaa L'anno completo (2001 viene visualizzato come "2001").

Si applica a

Vedi anche