DateString-Eigenschaft

Aktualisiert: November 2007

Gibt einen String-Wert zurück bzw. legt einen String-Wert fest, der das aktuelle Datum gemäß den Systemeinstellungen angibt.

Public Property DateString As String

Ausnahmen

Ausnahmetyp

Fehlernummer

Bedingung

InvalidCastException

5

Wert von DateString wurde mit ungültigem Format festgelegt.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

DateString gibt das Systemdatum stets als "MM-dd-yyyy" zurück, d. h., der abgekürzte Name des Monats wird verwendet. Folgende Formate sind zum Einstellen des Datums zulässig: "M-d-yyyy", "M-d-y", "M/d/yyyy" und "M/d/y". Diese Formate bleiben unabhängig von der jeweiligen Kultur gleich. Das bedeutet, dass sie sich nicht ändern, auch wenn Sie in der Systemsteuerung die Regionalen Einstellungen ändern.

Um die aktuelle Systemzeit als String-Wert abzurufen oder festzulegen, verwenden Sie die TimeString-Eigenschaft.

Um das aktuelle Systemdatum oder die aktuelle Systemzeit in Ihrem Gebietsschemaformat oder in einem benutzerdefinierten Format abzurufen, geben Sie die Now-Eigenschaft für die Format-Funktion an. Geben Sie dabei entweder Vordefinierte Datums-/Zeitformate (Format-Funktion) oder Benutzerdefinierte Datums-/Zeitformate (Format-Funktion) an. Das folgende Beispiel veranschaulicht dies.

MsgBox("The formatted date is " & Format(Now, "dddd, d MMM yyyy"))

Wenn Sie auf das aktuelle Systemdatum als Date-Wert zugreifen möchten, verwenden Sie die Today-Eigenschaft.

Sicherheitshinweis:

Das Einstellen des Systemdatums oder der Systemzeit erfordert eine Berechtigung für nicht verwalteten Code. Dies könnte sich auf dessen Ausführung in teilweise vertrauenswürdigen Kontexten auswirken. Weitere Informationen finden Sie unter SecurityPermission und Codezugriffsberechtigungen.

Beispiel

Im folgenden Beispiel wird mithilfe der DateString-Eigenschaft das aktuelle Systemdatum angezeigt.

MsgBox("The current date is " & DateString)

Anforderungen

Namespace:Microsoft.VisualBasic

**Modul:**DateAndTime

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Da DateString ein Member eines Moduls ist und nicht einer Klasse, müssen Sie kein Objekt für den Zugriff auf DateString erstellen.

Hinweise für Entwickler intelligenter Geräte

Mit der DateString-Eigenschaft können Sie das Systemdatum abrufen, jedoch nicht einstellen.

Siehe auch

Referenz

Now-Eigenschaft

TimeString-Eigenschaft

Today-Eigenschaft

Date-Datentyp (Visual Basic)

DateTime