Teilen über

DateTimePicker.CustomFormat Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft die benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit ab oder legt diese fest.

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

Eigenschaftswert

String

Eine Zeichenfolge, die das benutzerdefinierte Datums- und Zeitformat darstellt. Der Standardwert ist null.

Beispiele

Im folgenden Codebeispiel wird die CustomFormat Eigenschaft so festgelegt, dass das DateTimePicker Datum als "01. Juni 2001 - Freitag" angezeigt wird. Dieser Code geht davon aus, dass eine Instanz eines DateTimePicker Steuerelements auf einer 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

Hinweise

Um Zeichenfolgenliterale anzuzeigen, die Datums- und Uhrzeittrennzeichen enthalten oder Zeichenfolgen formatieren möchten, müssen Sie Escapezeichen in der Teilzeichenfolge verwenden. Wenn Sie beispielsweise das Datum als "15. Juni um 12:00 Uhr" anzeigen möchten, legen Sie die CustomFormat Eigenschaft auf "MMMM dd 'at' t:mm tt" fest. Wenn die Teilzeichenfolge "at" nicht durch Escapezeichen eingeschlossen ist, lautet das Ergebnis "15. Juni aP 12:00PM", da das Zeichen "t" als ein Buchstabe A.M./P.M. gelesen wird. Formatzeichenfolge (siehe unten die Formatzeichenfolgentabelle).

Die Formatzeichenfolgen können kombiniert werden, um das Datum und die Uhrzeit zu formatieren. Um beispielsweise das Datum und die Uhrzeit als 06.15.2001 12:00 Uhr anzuzeigen, sollte diese Eigenschaft auf "MM'/'dd'/'yyyy hh':'mm tt" festgelegt werden. Weitere Informationen finden Sie unter Benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen.

Hinweis

Die Format Eigenschaft muss für diese Eigenschaft festgelegt DateTimePickerFormat.Custom werden, um die Formatierung des angezeigten Datums und der Uhrzeit zu beeinflussen.

In der folgenden Tabelle sind alle gültigen Formatzeichenfolgen und deren Beschreibungen aufgeführt.

Formatzeichenfolge BESCHREIBUNG
T Der ein- oder zweistellige Tag.
dd Der zweistellige Tag. Einstellige Tageswerte werden einem 0 vorangestellt.
ddd Die Abkürzung für drei Zeichen pro Woche.
dddd Der name der ganzen Woche.
h Die ein- oder zweistellige Stunde im 12-Stunden-Format.
hh Die zweistellige Stunde im 12-Stunden-Format. Einstellige Werte werden einem 0 vorangestellt.
H Die ein- oder zweistellige Stunde im 24-Stunden-Format.
HH Die zweistellige Stunde im 24-Stunden-Format. Einstellige Werte werden einem 0 vorangestellt.
m Die ein- oder zweistellige Minute.
MM Die zweistellige Minute. Einstellige Werte werden einem 0 vorangestellt.
M Die ein- oder zweistellige Monatsnummer.
MM Die zweistellige Monatsnummer. Einstellige Werte werden einem 0 vorangestellt.
MMM Die Abkürzung für drei Zeichen.
MMMM Der vollständige Monatsname.
s Die ein- oder zweistellige Sekunden.
ss Die zweistelligen Sekunden. Einstellige Werte werden einem 0 vorangestellt.
t Der Einbuchstaben A.M./P.M. Abkürzung (A.M. wird als "A" angezeigt.
tt Der Zweibuchstaben A.M./P.M. Abkürzung (A.M. wird als "AM" angezeigt.
j Das einstellige Jahr (2001 wird als "1") angezeigt.
yy Die letzten beiden Ziffern des Jahres (2001 wird als "01") angezeigt.
yyyy Das Gesamte Jahr (2001 wird als "2001") angezeigt.

Gilt für

Siehe auch