TimeString-Eigenschaft

Aktualisiert: November 2007

Gibt einen String-Wert zurück bzw. legt diesen fest, der die aktuelle Uhrzeit gemäß der Systemeinstellung angibt.

Public Property TimeString As String

Ausnahmen

Ausnahmetyp

Fehlernummer

Bedingung

InvalidCastException

5

Ungültiges Format, mit dem der Wert von TimeString festgelegt wurde.

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

TimeString gibt die Systemzeit stets als "HH:mm:ss" zurück, also im 24-Stunden-Format. Dieses Format bleibt unabhängig von der jeweiligen Kultur gleich. Das bedeutet, dass es sich nicht ändert, auch wenn Sie in der Systemsteuerung die Regionalen Einstellungen ändern.

Um das aktuelle Systemdatum als String-Wert abzurufen oder festzulegen, verwenden Sie die DateString-Eigenschaft.

Um das aktuelle Systemdatum oder die aktuelle Systemzeit in Ihrem Gebietsschema 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 time is " & Format(Now, "hh.mm.ss.fff tt"))

Wenn Sie auf die aktuelle Systemzeit als Date-Wert zugreifen möchten, verwenden Sie die TimeOfDay-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

In diesem Beispiel wird mit der TimeString-Eigenschaft das aktuelle Systemdatum zurückgegeben.

MsgBox("The current time is " & TimeString)

Anforderungen

Namespace:Microsoft.VisualBasic

**Modul:**DateAndTime

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

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

Hinweise für Entwickler intelligenter Geräte

Mit der TimeString-Eigenschaft können Sie die Systemzeit abrufen, jedoch nicht einstellen.

Siehe auch

Referenz

Now-Eigenschaft

DateString-Eigenschaft

TimeOfDay-Eigenschaft

Date-Datentyp (Visual Basic)

DateTime