Freigeben über

DateTimePicker.CustomFormat Eigenschaft

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
DateTimePicker.cs
Quelle:
DateTimePicker.cs
Quelle:
DateTimePicker.cs
Quelle:
DateTimePicker.cs
Quelle:
DateTimePicker.cs

Dient zum Abrufen oder Festlegen der benutzerdefinierten Datums-/Uhrzeitformatzeichenfolge.

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-/Uhrzeitformat darstellt. Der Standardwert lautet 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 in einem 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. Um beispielsweise das Datum als "15. Juni um 12:00 Uhr" anzuzeigen, 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 12:00PM", da das Zeichen "t" als Zeichenfolge im 1-Buchstaben-Format A.M./P.M. gelesen wird (siehe folgende Formatzeichenfolgentabelle).

Die Formatzeichenfolgen können kombiniert werden, um das Datum und die Uhrzeit zu formatieren. Um beispielsweise das Datum und die Uhrzeit als 15.06.2001 12:00 Uhr anzuzeigen, sollte diese Eigenschaft auf "MM'/'dd'/'yyyy hh':'mm" 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 angezeigten Uhrzeit zu beeinflussen.

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

Format-String Beschreibung
d Der ein- oder zweistellige Tag.
dd Der zweistellige Tag. Einstellige Tageswerte stehen vor einem Wert von 0.
ddd Die Abkürzung für den dreistelligen Wochentag.
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 Monatszahl. 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 Die A.M./P.M.-Abkürzung (A.M. wird als "A") angezeigt.
tt Die Abkürzung A.M./P.M. (A.M. wird als "AM" angezeigt).
y 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:

Weitere Informationen