FORMATF |
  
|
FORMATF |
|
Platziert eine Kommazahl formatiert auf dem Report.
Syntax
FORMATF(Wert, Format)
Formatiert den Wert in Wert nach den Vorgaben in Format und gibt das Ergebnis zurück.
Format funktionen
Bezeichner |
Beschreibung |
0 |
Platzhalter für eine Ziffer. Enthält der zu formatierende Wert an der Position eine Ziffer, an der im Format-String '0' steht, wird diese in den Ausgabe-String kopiert. Andernfalls wird das Zeichen '0' an dieser Position im Ausgabe-String gespeichert. |
# |
Platzhalter für eine Ziffer. Enthält der zu formatierende Wert an der Position eine Ziffer, an der im Format-String '#' steht, wird diese in den Ausgabe-String kopiert. Andernfalls wird an dieser Position kein Zeichen im Ausgabe-String gespeichert. |
. |
Dezimaltrennzeichen. Das erste '.'-Zeichen im Format-String bestimmt die Position des Dezimaltrennzeichens im formatierten Wert. Alle weiteren dieser Zeichen werden ignoriert. Das tatsächlich im Ausgabe-String verwendete Zeichen wird mit der globalen Variable DecimalSeparator festgelegt. Die Variable erhält als Standardwert den entsprechenden Eintrag in der Registerkarte Zahlen im Modul Ländereinstellungen der Windows-Systemsteuerung. |
, |
Tausendertrennzeichen. Enthält der Format-String ein oder mehrere ','-Zeichen, werden in den Ausgabe-String links des Dezimaltrennzeichens nach jeder Gruppe von drei Ziffern Ausendertrennzeichen eingefügt. Die Position und Anzahl der Trennzeichen im Format-String wirkt sich nicht auf die Ausgabe aus. Sie geben nur an, dass Trennzeichen eingefügt werden sollen. Das tatsächlich im Ausgabe-String verwendete Zeichen wird mit der globalen Variable ThousandSeparator festgelegt. Die Variable erhält als Standardwert den entsprechenden Eintrag in der Registerkarte Zahlen des Moduls Ländereinstellungen der Windows-Systemsteuerung. |
E+ |
Wissenschaftliche Schreibweise. Sind die Zeichen 'E+', 'E-', 'e+' oder 'e-' im Format-String enthalten, wird die Zahl in der wissenschaftlichen Schreibweise formatiert. Bis zu vier '0'-Zeichen können direkt nach 'E+', 'E-', 'e+' oder 'e-' angegeben werden, um die minimale Anzahl der Stellen im Exponenten festzulegen. Bei den Formaten 'E+' und 'e+' wird für positive Exponenten ein Pluszeichen und für negative Exponenten ein Minuszeichen in den String eingefügt. Bei den Formaten 'E-' und 'e-' wird lediglich für negative Exponenten ein Vorzeichen ausgegeben. |
'xx'/"xx" |
In halbe oder ganze Anführungszeichen eingeschlossene Zeichen wirken sich nicht auf die Formatierung aus und werden wie eingegeben angezeigt. |
; |
Trennt Abschnitte für positive, negative und Nullwerte im Format-String. |
Die Zeichen zwischen dem äussersten linken '0' vor dem Dezimaltrennzeichen und dem äussersten rechten '0' nach dem Dezimaltrennzeichen werden immer im Ausgabe-String angezeigt.
Die zu formatierende Zahl wird immer auf so viele Dezimalstellen gerundet, wie Ziffernplatzhalter ('0' oder '#') rechts des Dezimaltrennzeichens vorhanden sind. Enhält der Format-String kein Dezimaltrennzeichen, wird der Wert auf die nächste ganze Zahl gerundet.
Hat die zu formatierende Zahl mehr Vorkommastellen, als Ziffernplatzhalter links des '.' im Format-String vorhanden sind, werden die zusätzlichen Stellen vor dem ersten Platzhalter ausgegeben.
Damit für positive, negative und Nullwerte unterschiedliche Formate festgelegt werden können, kann der Format-String zwischen einem und drei durch Semikolons getrennte Abschnitte enthalten.
Ein Abschnitt: Der Format-String wird für alle Werte verwendet.
Zwei Abschnitte: Der erste Abschnitt wird für positive und Nullwerte, der zweite Abschnitt für negative Werte verwendet.
Drei Abschnitte: Der erste Abschnitt wird für positive, der zweite für negative, und der dritte Abschnitt für Nullwerte verwendet.
Wenn der Abschnitt für negative oder Nullwerte keine Angaben enthält, wird statt dessen der Abschnitt für positive Werte verwendet.
Ist der Abschnitt für positive Werte oder der gesamte Format-String leer, wird die Zahl im allgemeinen Gleitkommaformat mit 15 siginifikanten Stellen formatiert. Das allgemeine Gleitkommaformat wird auch verwendet, wenn mehr als 18 Vorkommastellen vorhanden sind und im Format-String nicht die wissenschaftliche Schreibweise angegeben wird.