Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft die benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit ab oder legt diese fest.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
<LocalizableAttribute(True)> _
Public Property CustomFormat As String
'Usage
Dim instance As DateTimePicker
Dim value As String
value = instance.CustomFormat
instance.CustomFormat = value
[LocalizableAttribute(true)]
public string CustomFormat { get; set; }
[LocalizableAttribute(true)]
public:
property String^ CustomFormat {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_CustomFormat ()
/** @property */
public void set_CustomFormat (String value)
public function get CustomFormat () : String
public function set CustomFormat (value : String)
Eigenschaftenwert
Eine Zeichenfolge, die das benutzerdefinierte Datums- und Zeitformat darstellt. Der Standardwert ist NULL (Nothing in Visual Basic).
Hinweise
Sie müssen in der Teilzeichenfolge Escapezeichen verwenden, um Zeichenfolgenliterale mit Trennzeichen für Datum und Uhrzeit oder Formatzeichenfolgen anzuzeigen. Wenn Sie z. B. als Datum "June 15 at 12:00 PM" anzeigen möchten, legen Sie die CustomFormat-Eigenschaft auf "MMMM dd 'at' t:mm tt" fest. Wenn die Teilzeichenfolge "at" nicht in Escapezeichen eingeschlossen ist, wird "June 15 aP 12:00PM" angezeigt, da das Zeichen "t" als einbuchstabige AM/PM-Formatzeichenfolge gelesen wird (siehe die nachfolgende Tabelle zu Formatzeichenfolgen).
Die Formatzeichenfolgen können zum Formatieren des Datums und der Uhrzeit kombiniert werden. Wenn Sie z. B. Datum und Uhrzeit als 06/15/2001 12:00 PM anzeigen möchten, muss diese Eigenschaft auf "MM'/'dd'/'yyyy hh':'mm tt" festgelegt werden. Weitere Informationen finden Sie unter Formatzeichenfolgen für Datum und Uhrzeit.
Hinweis
Die Format-Eigenschaft muss auf DateTimePickerFormat.Custom festgelegt sein, damit sich diese Eigenschaft auf die Formatierung des angezeigten Datums und der Uhrzeit auswirkt.
In der folgenden Tabelle werden alle gültigen Formatzeichenfolgen aufgeführt und beschrieben.
Formatzeichenfolge |
Beschreibung |
|---|---|
d |
Der Tag in ein oder zwei Ziffern. |
dd |
Der Tag in zwei Ziffern. Werten von einstelligen Tagen wird eine Null vorangestellt. |
ddd |
Die aus drei Buchstaben bestehende Abkürzung für den Wochentag. |
dddd |
Der vollständige Name des Wochentags. |
h |
Die Stunde in ein oder zwei Ziffern im 12-Stundenformat. |
hh |
Die Stunde in zwei Ziffern im 12-Stundenformat. Einstelligen Werten wird eine Null vorangestellt. |
H |
Die Stunde in ein oder zwei Ziffern im 24-Stundenformat. |
HH |
Die Stunde in zwei Ziffern im 24-Stundenformat. Einstelligen Werten wird eine Null vorangestellt. |
m |
Die Minute in ein oder zwei Ziffern. |
mm |
Die Minute in zwei Ziffern. Einstelligen Werten wird eine Null vorangestellt. |
M |
Die Monatszahl in ein oder zwei Ziffern. |
MM |
Die Monatszahl in zwei Ziffern. Einstelligen Werten wird eine Null vorangestellt. |
MMM |
Die aus drei Buchstaben bestehende Abkürzung für den Monat. |
MMMM |
Der vollständige Monatsname. |
s |
Die Sekunde in ein oder zwei Ziffern. |
ss |
Die Sekunde in zwei Ziffern. Einstelligen Werten wird eine Null vorangestellt. |
t |
Die einbuchstabige A.M./P.M.-Abkürzung (A.M. wird als "A" angezeigt ). |
tt |
Die zweibuchstabige A.M./P.M.-Abkürzung (A.M. wird als "AM" angezeigt ). |
y |
Das Jahr in einer Ziffer (2001 wird als "1" angezeigt). |
yy |
Die letzen beiden Ziffern des Jahres (2001 wird als "01" angezeigt). |
yyyy |
Die vollständige Jahreszahl (2001 wird als "2001" angezeigt). |
Beispiel
Im folgenden Codebeispiel wird die CustomFormat-Eigenschaft festgelegt, sodass der DateTimePicker das Datum als "Juni 01, 2001 - Freitag" anzeigt. In diesem Code wird davon ausgegangen, dass eine Instanz des DateTimePicker-Steuerelements in einem Form erstellt wurde.
Public Sub SetMyCustomFormat()
' Set the Format type and the CustomFormat string.
dateTimePicker1.Format = DateTimePickerFormat.Custom
dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
End Sub 'SetMyCustomFormat
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 void SetMyCustomFormat()
{
// Set the Format type and the CustomFormat string.
dateTimePicker1.set_Format(DateTimePickerFormat.Custom);
dateTimePicker1.set_CustomFormat("MMMM dd, yyyy - dddd");
} //SetMyCustomFormat
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0
Siehe auch
Referenz
DateTimePicker-Klasse
DateTimePicker-Member
System.Windows.Forms-Namespace
DateTimePickerFormat
Format