Die Format-Funktion formatiert den übergebenen Ausdruck entsprechend den angegebenen Anweisungen und gibt den formatierten Ausdruck zurück.
Syntax | ||||
Format(Expr , [FormatString [,FirstDayOfWeek [,FirstWeekOfYear ]]]) | ||||
Rückgabewert | ||||
Typ |
Beschreibung | |||
String |
| |||
Parameter | ||||
Verwendung |
Name |
Typ |
Übergabe |
Beschreibung |
Erforderlich |
Expr |
Variant |
ByVal |
Zu formatierender Ausdruck |
Optional |
FormatString |
String |
ByVal |
Formatangabe |
Optional |
FirstDayOfWeek |
Long |
ByVal |
Erster Tag der Woche |
Optional |
FirstWeekOfYear |
Long |
ByVal |
Erste Woche des Jahres |
Geben über den Parameter FormatString einen gültigen Formatausdruck ein.
Falls Sie für positive und negative Werte sowie für den Null-Wert unterschiedliche Formate angeben möchen, trennen Sie diese durch ein Semikolon:
z.B.
#,##0.00; - #,##0.00; \N\U\L\L
Verwenden Sie hierfür folgende Formatierungen (Änderungen vorbehalten):
Formatzeichen |
Beschreibung |
# |
Ziffer |
0 |
Ziffer, eine Null wird immer ausgegeben |
. (Punkt) |
Dezimaltrennzeichen |
, (Komma) |
Tausendertrennzeichen |
/ |
Trennzeichen für Datumsangaben |
: |
Trennzeichen für Zeitangaben |
DD |
Tag |
MM |
Monat |
MMM |
Monat in ausgeschriebener Darstellung |
W |
Tag der Woche |
Ww |
Woche des Jahres |
Q |
Quartal des Jahres |
AMPM |
Vormittag (A) / Nachmittag (P) |
YY |
Jahr in zweistelliger Darstellung |
YYY |
Jahr in ausgeschriebener Darstellung |
YYYY |
Jahr in vierstelliger Darstellung |
Hh |
Stunde |
Nn |
Minute |
Ss |
Sekunde |
- |
Vorzeichen |
% |
Umrechnung in Prozent |
> |
Wandelt einen Text in Großbuchstaben |
< |
Wandelt einen Text in Kleinbuchstaben |
X |
Ein Zeichen (das erste) |
X(10) |
Linksbündig in zehn Leerstellen (maximal 10 Stellen), überzählige Zeichen werden abgeschnitten |
Z(10.2) |
Rechtsbündig Ganzzahlwert in zehn Nullzeichen, Linksbündig Dezimalwert in 2 Nullzeichen |
\D |
Das Zeichen D wird ausgegeben (Backslash vor dem Zeichen ignoriert die Formatanweisung |
@ |
Rechtsbündige Ausgabe von Text |
FirstDayOfWeek |
Beschreibung |
1 |
Sonntag (Default-Wert) |
2 |
Montag |
3 |
Dienstag |
4 |
Mittwoch |
5 |
Donnerstag |
6 |
Freitag |
7 |
Samstag |
FirstWeekOfYear |
Beschreibung |
1 |
Woche, in der der 1. Januar liegt |
2 |
Woche, in der mindestens vier Tage des neuen Jahres liegen |
3 |
erste vollständige Woche des neuen Jahres |
Bemerkungen
Beim Formatieren einer Zahl ohne die Angabe von Format liefert Format dasselbe Ergebnis wie die Str-Funktion, obwohl es auf die jeweilige Gebietsschemaeinstellung reagiert. Allerdings fehlt bei positiven Zahlen, die mit Format als Zeichenfolgen formatiert wurden, das für Vorzeichen reservierte führende Leerzeichen. Die mit Str umgewandelten Zahlen behalten das führende Leerzeichen.