Format-Funktion

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

Warnung    Bei der Verwendung dieser Funktion ist ein Problem aufgetreten. Der letzte Montag in einigen Kalenderjahren kann als Woche 53 zurückgegeben werden, wenn es sich um eine Woche 1 handeln sollte. Weitere Informationen und eine Problemumgehung finden Sie unter Funktionen für Format oder datepart können eine falsche Wochennummer für den letzten Montag im Jahr zurückgeben.

Hier sind einige Beispiele

Syntax

Format( Ausdruck [, Format ] [, ErsterTagDerWoche ] [, ErsteWocheDesJahres ] )

Die Syntax der Funktion Format weist die folgenden Argumente auf:

Argument

Beschreibung

Ausdruck

Erforderlich. Ein beliebiger gültiger Ausdruck.

Format

Optional. Ein gültiger benannter oder benutzerdefinierter Formatausdruck.

ErsterTagDerWoche

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

ErsteWocheDesJahres

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


Einstellungen

Das Argument " Format " kann je nach Datentyp des Ausdrucks Arguments eine Vielzahl von Einstellungen verwenden. In den in der folgenden Tabelle aufgeführten Artikeln finden Sie weitere Informationen zu gültigen Formatausdrücke.

Informationen zu Ausdrücken mit diesem Datentyp ...

... finden Sie in diesem Artikel

Beliebiger Datentyp

Format-Eigenschaft

Datum/Uhrzeit

Formatieren eines Datums-und Uhrzeit Felds

Zahl (numerisch)

Formatieren einer Zahl oder eines währungsfelds

Text und Memo

Formatieren eines Textfelds

Ja/Nein

Format-Eigenschaft – Yes/No (Datentyp)


Das Argument ErsterTagDerWoche verfügt über folgende Einstellungen:

Konstante

Wert

Beschreibung

vbUseSystem

0

NLS API-Einstellung verwenden

VbSunday

1

Sonntag (Standard)

vbMonday

2

Montag

vbTuesday

3

Dienstag

vbWednesday

4

Mittwoch

vbThursday

5

Donnerstag

vbFriday

6

Freitag

vbSaturday

7

Samstag


Das Argument ErsteWocheDesJahres verfügt über folgende Einstellungen:

Konstante

Wert

Beschreibung

vbUseSystem

0

NLS API-Einstellung verwenden

vbFirstJan1

1

Mit der Woche beginnen, in die der 1. Januar fällt (Standard).

vbFirstFourDays

2

Mit der ersten Woche beginnen, die mindestens vier Tage des neuen Jahres enthält.

vbFirstFullWeek

3

Mit der ersten vollen Woche des Jahres beginnen.


Hinweise

Formatierung

Vorgehensweise

Zahlen

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

Datums- und Uhrzeitwerte

Verwenden Sie vordefinierte benannte Datums-/Uhrzeitformate, oder erstellen Sie benutzerdefinierte Datums-/Uhrzeitformate.

Datum und Uhrzeit, fortlaufende Nummern

Verwenden Sie Datums-/Uhrzeitformate oder numerische Formate.

Zeichenfolgen

Erstellen Sie eigene benutzerdefinierte Zeichenfolgenformate.


Wenn Sie versuchen, eine Zahl ohne Angabe von Formatzu formatieren, bietet Format Funktionen ähnlich der Str -Funktion, obwohl Sie International bekannt ist. Positive Zahlen, die mit Format als Zeichenfolgen formatiert sind, enthalten jedoch kein führendes Leerzeichen, das für das Vorzeichen des Werts reserviert ist. die konvertierten mit Str behalten das führende Leerzeichen bei.

Wenn Sie eine nicht lokalisierte numerische Zeichenfolge formatieren, sollten Sie ein benutzerdefiniertes Zahlenformat verwenden, um sicherzustellen, dass das Ergebnis Ihren Vorstellungen entspricht.

Hinweis: Wenn für die Eigenschaft Calendar die Einstellung "Gregorian" verwendet wird und Format das Datumsformat angibt, muss für Ausdruck der Wert "Gregorian" angegeben werden. Wenn für die Visual Basic-Eigenschaft Calendar die Einstellung "Hijri" lautet, muss für Ausdruck der Wert "Hijri" angegeben werden.

Wenn es sich bei dem Kalender um einen gregorianischen Kalender handelt, bleibt die Bedeutung der Format Ausdrucks Symbole unverändert. Wenn es sich um einen Hijri-Kalender handelt, haben alle Datumsformat Symbole (beispielsweise dddd, mmmm, yyyy) die gleiche Bedeutung, gelten aber für den Hijri-Kalender. Format Symbole verbleiben in Englisch; Symbole, die zur Textanzeige führen (beispielsweise "am" und "PM") zeigen die Zeichenfolge (Englisch oder Arabisch) an, die diesem Symbol zugeordnet ist. Der Bereich bestimmter Symbole ändert sich, wenn es sich um einen Hijri-Kalender handelt.

Symbol

Bereich

d

1-30

dd

1-30

ww

1-51

mmm

Zeigt den vollständigen Monatsnamen an (Hijri-Monatsnamen haben keine Abkürzung).

y

1-355

yyyy

100-9666

Beispiele

Verwenden der Format-Funktion in einem Ausdruck    Sie können Format überall verwenden, wo Ausdrücke zulässig sind. Beispielsweise können Sie sie in einer Abfrage als Teil eines Feldalias oder in der Control Source-Eigenschaft eines Textfelds in einem Formular oder einem Bericht verwenden. Das folgende Beispiel zeigt einen Ausdruck, den Sie in einer Filter-Eigenschaft eines Berichts verwenden können, um die Ausgabe auf Datensätze der vorherigen Woche zu beschränken.

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

In diesem Beispiel verfügt die Datensatzquelle des Berichts über ein Feld namens "Datum", das das Datum enthält, an dem jeder einzelne Datensatz, der im Bericht verwendet wird, geändert wurde. Beim Ausführen des Berichts werden die Ergebnisse so gefiltert, dass nur die Datensätze angezeigt werden, bei denen der Wert im Feld "Datum" (Format([Datum],"ww")) der vorherigen Woche entspricht (Format(Now(),"ww")-1).

Verwenden der Format-Funktion in VBA-Code    

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

In diesem Beispiel werden unterschiedliche Verwendungsmöglichkeiten der Format-Funktion gezeigt, um Werte mithilfe von benannten und benutzerdefinierten Formaten zu formatieren. Für das Datumstrennzeichen (/), das Zeittrennzeichen (:) und das AM/PM-Literal hängt die tatsächliche formatierte, von Ihrem System angezeigte Ausgabe von den Gebietsschemaeinstellungen des Computers ab, auf dem der Code ausgeführt wird. Wenn Uhrzeit und Datum in der Entwicklungsumgebung angezeigt werden, wird das kurze Uhrzeit-/Datumsformat des Code-Gebietsschemas verwendet. Bei der Anzeige durch Ausführen des Codes wird das kurze Uhrzeit-/Datumsformat des System-Gebietsschemas verwendet, welches vom Code-Gebietsschema abweichen kann. Für dieses Beispiel verwenden wir Englisch (USA).

MyTime und MyDate werden in der Entwicklungsumgebung mit der kurzen Uhrzeit-/Datumseinstellung des Systems 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 Microsoft Access 2.0 und früher konnten Sie die Format-Funktion verwenden, um für eine Leere Zeichenfolge einen Wert und für einen Wert einen anderen Wert zurückzugeben. Sie konnten z. B. einen Formatausdruck wie etwa 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 Microsoft Access 97 und höher müssen Sie separat auf den Nullwert testen, und den entsprechenden Wert basierend auf dem Ergebnis zurückgeben. Sie könnten beispielsweise die IIf-Funktion in einem Ausdruck mit der Format-Funktion verwenden, wie im Folgenden dargestellt:

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

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

Wenn Sie eine Datenbank von Microsoft Access 2.0 oder früher in Microsoft Access 2002 oder höher konvertieren, müssen Sie Code ändern, um separat auf NULL-Werte zu testen.

Siehe auch

Zeichenfolgenfunktionen und ihre Verwendung

Ihre Office-Fähigkeiten erweitern
Schulungen erkunden
Neue Funktionen als Erster erhalten
Office Insider werden

War diese Information hilfreich?

Vielen Dank für Ihr Feedback!

Vielen Dank für Ihr Feedback. Es klingt, als ob es hilfreich sein könnte, Sie mit einem unserer Office-Supportmitarbeiter zu verbinden.

×