Format-Funktion

Artikel
08/20/2008

Aktualisiert: November 2007

Gibt eine Zeichenfolge zurück, die entsprechend den Anweisungen in einem String-Formatausdruck formatiert ist.

Public Shared Function Format( _
   ByVal Expression As Object, _
   Optional ByVal Style As String = "" _
) As String

Parameter

Expression
Erforderlich. Ein beliebiger gültiger Ausdruck.
Style
Optional. Ein gültiger benannter oder benutzerdefinierter String-Formatausdruck.

Einstellungen

Informationen zur Erstellung des Style-Arguments finden Sie unter einem der folgenden Themen:

Formatierung von	Vorgehensweise
Zahlen	Verwenden Sie Vordefinierte numerische Formate (Format-Funktion) oder erstellen Sie Benutzerdefinierte numerische Formate (Format-Funktion).
Datum und Uhrzeit	Verwenden Sie Vordefinierte Datums-/Zeitformate (Format-Funktion), oder erstellen Sie Benutzerdefinierte Datums-/Zeitformate (Format-Funktion).
Zahlenfolgen für Datums- und Zeitangaben	Verwenden Sie Datums- und Zeitformate oder numerische Formate.

Wenn Sie versuchen, eine Zahl ohne Angabe des Style-Arguments zu formatieren, ist die Funktionalität der Format-Funktion mit der der Str-Funktion vergleichbar, wobei jedoch das Gebietsschema berücksichtigt wird. Positive Zahlen, die mithilfe der Format-Funktion als Zeichenfolgen formatiert werden, weisen jedoch kein führendes Leerzeichen zur Angabe des Vorzeichens auf. Zahlen, die mit der Str-Funktion konvertiert werden, behalten hingegen das führende Leerzeichen.

Hinweise

Wenn Sie eine nicht lokalisierte numerische Zeichenfolge formatieren, sollten Sie ein benutzerdefiniertes numerisches Format verwenden, um das gewünschte Erscheinungsbild zu erhalten.

Die String.Format-Methode stellt eine ähnliche Funktionalität bereit.

Beispiel

Dieses Beispiel zeigt verschiedene Verwendungsmöglichkeiten der Format-Funktion zur Formatierung von Werten mit String-Formaten und benutzerdefinierten Formaten. Die tatsächlich von Ihrem System ausgegebene Formatierung von Datumstrennzeichen (/), Trennzeichen für Zeitangaben (:) und AM/PM-Indikatoren (t und tt) richtet sich nach den Gebietsschemaeinstellungen des Codes. Wenn Datums- und Zeitangaben in der Entwicklungsumgebung angezeigt werden, werden das 24-Stunden-Zeitformat und das kurze Datumsformat des für den Code ausgewählten Gebietsschemas verwendet.

Hinweis:
Für Gebietsschemas, die das 24-Stunden-Format verwenden, zeigen die AM/PM-Indikatoren (t und tt) nichts an.

Dim TestDateTime As Date = #1/27/2001 5:04:23 PM#
Dim TestStr As String
' Returns current system time in the system-defined long time format.
TestStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
TestStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date 
' format, using the single letter code for the format.
TestStr = Format(Now(), "D")

' Returns the value of TestDateTime in user-defined date/time formats.
' Returns "5:4:23".
TestStr = Format(TestDateTime, "h:m:s")
' Returns "05:04:23 PM".
TestStr = Format(TestDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
TestStr = Format(TestDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
TestStr = Format(TestDateTime, "HH:mm:ss")
' Returns "23".
TestStr = Format(23)

' User-defined numeric formats.
' Returns "5,459.40".
TestStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
TestStr = Format(334.9, "###0.00")
' Returns "500.00%".
TestStr = Format(5, "0.00%")