Format-Funktion

Gibt einen Wert vom Typ Variant ( String) zurück, der einen Ausdruck enthält, der entsprechend der in einem Formatausdruck enthaltenen Anweisungen formatiert ist.

Beispiele

Syntax

Format(expression [, format ] [, firstdayofweek ] [, firstweekofyear ] )

Die Format-Funktionssyntax verwendet die folgenden Argumente:

Argument

Beschreibung

expression

Erforderlich. Jeder gültige Ausdruck.

format

Optional. Ein gültiger benannter oder benutzerdefinierter Formatausdruck.

firstdayofweek

Optional. Eine Konstante, die den ersten Tag der Woche angibt.

firstweekofyear

Optional. Eine Konstante, die die erste Woche des Jahres angibt.


Einstellungen

Das format-Argument kann je nach dem Datentyp des expression-Arguments unterschiedliche Einstellungen annehmen. Weitere Informationen zu gültigen Formatausdrücken finden Sie in den in der folgenden Tabelle aufgeführten Artikeln.

Informationen zu Ausdrücken mit dem folgenden Datentyp...

Finden Sie im folgenden Artikel

Beliebiger Typ

Format-Eigenschaft

Datum/Uhrzeit

Format-Eigenschaft - Datum/Uhrzeit (Datentyp)

Numerisch

Format-Eigenschaft - Zahl und Währung (Datentypen)

Text und Memo

Format-Eigenschaft - Text und Memo (Datentypen)

Ja/Nein

Format-Eigenschaft – Ja/Nein-Datentyp


Das Argument firstdayofweek verwendet die folgenden Einstellungen:

Konstante

Wert

Beschreibung

vbUseSystem

0

Verwendet die NLS API-Einstellung.

VbSunday

1

Sonntag (Standard)

vbMonday

2

Montag

vbTuesday

3

Dienstag

vbWednesday

4

Mittwoch

vbThursday

5

Donnerstag

vbFriday

6

Freitag

vbSaturday

7

Samstag


Das Argumentfirstweekofyear verwendet die folgenden Einstellungen:

Konstante

Wert

Beschreibung

vbUseSystem

0

Verwendet die NLS API-Einstellung.

vbFirstJan1

1

Beginnt mit der Woche, in die der 1. Januar fällt (Standard).

vbFirstFourDays

2

Beginnt mit der ersten Woche, die mindestens über vier Tage in dem Jahr verfügt.

vbFirstFullWeek

3

Beginnt mit der ersten vollen Woche des Jahres.


Hinweise

Formatierung von

Aktion

Zahlen

Verwenden Sie numerische, vordefinierte und benannte Formate, oder erstellen Sie numerische benutzerdefinierte Formate.

Datums- und Zeitangaben

Verwenden Sie vordefinierte, benannte Datums- und Zeitformate, oder erstellen Sie benutzerdefinierte Datums- und Zeitformate.

Fortlaufende Zahlen für Datum und Uhrzeit

Verwenden Sie Datums- und Uhrzeitformate oder numerische Formate.

Zeichenfolgen

Erstellen Sie eigene benutzerdefinierte Zeichenfolgenformate.


Wenn Sie versuchen, eine Zahl zu formatieren, ohne Format anzugeben, bietet Format der Str-Funktion ähnliche Funktionalität, obwohl sie international anerkannt ist. Positive Zahlen, die unter Verwendung von Format als Zeichenfolgen formatiert sind, enthalten jedoch kein führendes Leerzeichen, das für das Vorzeichen des Werts reserviert ist. Die mithilfe von Str konvertierten Zahlen behalten jedoch das führende Leerzeichen bei.

Wenn Sie eine nicht-lokalisierte numerische Zeichenfolge formatieren, sollten Sie ein benutzerdefiniertes numerisches Format verwenden, um sicherzustellen, dass Sie das erhalten, was Sie möchten.

Hinweis : Wenn die Einstellung der Calendar-Eigenschaft auf Gregorianisch festgelegt ist und wenn Format die Datumsformatierung angibt, muss der angegebene expression Gregorianisch sein. Wenn die Calendar-Eigenschaft von Visual Basic auf Hijri festgelegt ist, muss Hijri der angegebene expression sein.

Wenn es sich um einen gregorianischen Kalender handelt, bleibt die Bedeutung von format-Ausdruckssymbolen unverändert. Wenn es sich um einen Hijri-Kalender handelt, haben alle Datumsformatsymbole (beispielsweise MMMM, mmmm JJJJ) dieselbe Bedeutung, gelten aber für den Hijri-Kalender. Die Formatsymbole bleiben Englisch. Symbole, die zur Textanzeige (beispielsweise AM und PM) führen, zeigen die mit dem Symbol verknüpfte Zeichenfolge (Englisch oder Arabisch) an. Wenn es sich um einen Hijri-Kalender handelt, ändert sich der Bereich bestimmter Symbole.

Symbol

Bereich

d

1 -30

dd

1 -30

ww

1 -51

mmm

Zeigt vollständige Monatsnamen an (Hijri-Monatsnamen haben keine Abkürzungen).

y

1 -355

yyyy

100 -9666

Beispiele

Verwenden der Format-Funktion in einem Ausdruck    Die Format-Funktion kann an Stellen verwendet werden, an denen Ausdrücke verwendet werden. Sie können sie beispielsweise in einer Abfrage als Teil eines Feldalias oder in der ControlSource-Eigenschaft eines Textfelds in einem Formular oder Bericht verwenden. Im folgenden Beispiel ist ein Ausdruck dargestellt, der in der Filter-Eigenschaft eines Berichts verwendet werden kann, um die Ausgabe auf Datensätze aus der vorherigen Woche zu beschränken.

Format([Datum],"ww")=Format(Jetzt(),"ww")-1

In diesem Beispiel befindet sich in der Datensatzquelle des Berichts ein Feld mit der Bezeichnung Datum, das das Datum enthält, zu dem die einzelnen Datensätze jeweils geändert wurden, und das im Bericht verwendet wird. Beim Ausführen des Berichts werden die Ergebnisse gefiltert, sodass nur die Datensätze angezeigt werden, bei denen die Woche für den Wert im Datum-Feld (Format([Datum],"ww")) mit der vorherigen Woche (Format(Jetzt(),"ww")-1) übereinstimmt.

Verwenden der Format-Funktion in VBA-Code    

Hinweis : Die folgenden Beispiele zeigen die Verwendung dieser Funktion in einem VBA-Modul (Visual Basic für Applikationen). Wenn Sie weitere Informationen zum Arbeiten mit VBA wünschen, wählen Sie Entwicklerhilfe in der Dropdownliste neben Suchen, und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.

Dieses Beispiel zeigt verschiedene Verwendungen der Format-Funktion für die Formatierung von Werten mithilfe von benannten Formaten und benutzerdefinierten Formaten. Als Trennzeichen für die Datumsangabe (/), die Uhrzeitangabe (:) und als AM/PM-Literal richtet sich die tatsächlich formatierte Ausgabe, die von Ihrem System angezeigt wird, nach den Gebietsschemaeinstellungen des Computers, unter denen der Code ausgeführt wird. Wenn die Uhrzeit und das Datum in der Entwicklungsumgebung angezeigt werden, werden das kurze Zeitformat und das kurze Datumsformat des Codegebietsschemas verwendet. Wenn die Uhrzeit und das Datum vom ausgeführten Code angezeigt werden, werden das kurze Zeitformat und das kurze Datumsformat des Gebietsschemas verwendet, was sich vom Codegebietsschema unterscheiden kann. Für dieses Beispiel wird die Gebietsschemaeinstellung für Englisch (USA) angenommen.

MyTime und MyDate werden in der Entwicklungsumgebung unter Verwendung der aktuellen Systemeinstellung für kurze Zeit und kurzes Datum angezeigt.

Dim MyTime, MyDate, MyStr
MyTime = #17:04:23#
MyDate = #January 27, 1993#
' Returns current system time in the system-defined long time format.
MyStr = Format(Time, "Long Time")
' Returns current system date in the system-defined long date format.
MyStr = Format(Date, "Long Date")
MyStr = Format(MyTime, "h:m:s") ' Returns "17:4:23".
MyStr = Format(MyTime, "hh:mm:ss AMPM") ' Returns "05:04:23 PM".
MyStr = Format(MyDate, "dddd, mmm d yyyy") ' Returns "Wednesday,
' Jan 27 1993".
' If format is not supplied, a string is returned.
MyStr = Format(23) ' Returns "23".
' User-defined formats.
MyStr = Format(5459.4, "##,##0.00") ' Returns "5,459.40".
MyStr = Format(334.9, "###0.00") ' Returns "334.90".
MyStr = Format(5, "0.00%") ' Returns "500.00%".
MyStr = Format("HELLO", "<") ' Returns "hello".
MyStr = Format("This is it", ">") ' Returns "THIS IS IT".


Verwenden von Format mit leeren Zeichenfolgen

In den Microsoft Access-Version 2.0 und früher könnten Sie die Format-Funktion verwenden, um einen Wert für eine Leere Zeichenfolge und einen anderen für einen Wert zurückzugeben. Sie könnten z. B. einen Formatausdruck wie den folgenden mit der Format-Funktion verwenden, um den entsprechenden Zeichenfolgenwert aus Code zurückzugeben:

Dim varX As Variant
Dim varStrX As Variant
' Assign some value to varStrX and pass to Format function.
varX = Format(varStrX, "@;ZLS;Null")

In den Microsoft Access-Versionen 97 und höher müssen Sie den Fall Null separat testen und dann den entsprechenden Wert basierend auf dem Ergebnis zurückgeben. Sie könnten z. B. die Wenn-Funktion in einem Ausdruck mit der Format-Funktion wie folgt verwenden:

varX = IIf(IsNull(varStrX),"Null", Format(varStrX, "@;ZLS"))

Diese Änderung gilt nur, wenn Sie die Format-Funktion zur Formatierung einer Zeichenfolge abhängig davon verwenden, ob es sich um eine leere Zeichenfolge oder um einen Null-Wert handelt. Andere, mit der Format-Funktion verwendete Formatausdrücke funktionieren weiterhin wie in früheren Versionen.

Wenn Sie eine Datenbank aus Microsoft Access Version 2.0 und früher in Microsoft Access 2002 oder höher konvertieren, müssen Sie den Code ändern, um den Null-Fall separat zu testen.

Teilen Facebook Facebook Twitter Twitter E-Mail E-Mail

War diese Information hilfreich?

Sehr gut. Noch anderes Feedback?

Was können wir verbessern?

Vielen Dank für Ihr Feedback!

×