Formatiert einen Gleitkommawert.

Aufbau

FormatFloat(const Format: string; Value: Extended): string;

Parameter

Rückgabewert

Beschreibung

FormatFloat formatiert den durch Value angegebenen Gleitkommawert unter Verwendung der durch Format angegebenen Formatzeichenfolge. Die folgenden Formatbezeichner werden in der Formatzeichenfolge unterstützt:

Der Spezifizierer steht für „

“ – Platzhalter für eine Ziffer. Wenn der zu formatierende Wert an der Stelle, an der die „0“ in der Formatzeichenfolge steht, eine Ziffer enthält, wird diese Ziffer in die Ausgabekenfolge übernommen. Andernfalls wird an dieser Stelle in der Ausgabekette eine „0“ gespeichert.

Platzhalter für eine Ziffer. Wenn der zu formatierende Wert an der Stelle, an der das Zeichen „#“ in der Formatzeichenfolge steht, eine Ziffer enthält, wird diese Ziffer in die Ausgabekenfolge übernommen. Andernfalls wird an dieser Stelle in der Ausgabekette nichts gespeichert.

. Dezimalpunkt. Das erste „.“ im Formatzeichenfolgen bestimmt die Position des Dezimaltrennzeichens im formatierten Wert; alle weiteren „.“ werden ignoriert. Das Zeichen, das in der Ausgabekette als Dezimaltrennzeichen verwendet wird, wird durch die globale Variable „DecimalSeparator“ festgelegt. Der Standardwert für „DecimalSeparator“ wird im Abschnitt „Zahlenformat“ unter „International“ in der Windows-Systemsteuerung festgelegt.

, Tausendertrennzeichen. Wenn die Formatzeichenfolge ein oder mehrere Kommas enthält, werden in der Ausgabe vor dem Dezimalpunkt zwischen jeder Gruppe von drei Ziffern Tausendertrennzeichen eingefügt. Die Position und Anzahl der Kommas in der Formatzeichenfolge hat keinen Einfluss auf die Ausgabe, außer um anzugeben, dass Tausendertrennzeichen gewünscht sind. Welches Zeichen in der Ausgabe als Tausendertrennzeichen verwendet wird, wird durch die globale Variable „ThousandSeparator“ festgelegt. Der Standardwert für „ThousandSeparator“ wird im Bereich „Zahlenformat“ des Abschnitts „International“ in der Windows-Systemsteuerung festgelegt.

E+ Wissenschaftliche Schreibweise. Wenn die Formatzeichenfolge eine der Zeichenfolgen „E+“, „E-“, „e+“ oder „e-“ enthält, wird die Zahl in wissenschaftlicher Notation formatiert. Auf die Zeichen „E+“, „E-“, „e+“ oder „e-“ kann unmittelbar eine Gruppe von bis zu vier Nullen folgen, um die Mindestanzahl der Stellen im Exponenten festzulegen. Bei den Formaten „E+“ und „e+“ wird bei positiven Exponenten ein Pluszeichen und bei negativen Exponenten ein Minuszeichen ausgegeben. Die Formate „E-“ und „e-“ geben nur bei negativen Exponenten ein Vorzeichen aus.

Zeichen, die in einfache oder doppelte Anführungszeichen gesetzt sind, werden unverändert ausgegeben und haben keinen Einfluss auf die Formatierung.

; Trennt in der Formatzeichenfolge die Abschnitte für positive, negative und Nullzahlen.

Die Positionen der „0“ ganz links vor dem Dezimalpunkt in der Formatzeichenfolge und der „0“ ganz rechts nach dem Dezimalpunkt in der Formatzeichenfolge bestimmen den Bereich der Ziffern, die in der Ausgabekenfolge immer vorhanden sind.

Die zu formatierende Zahl wird immer auf so viele Dezimalstellen gerundet, wie sich rechts vom Dezimalpunkt Platzhalter („0“ oder „#“) befinden. Enthält die Formatzeichenfolge keinen Dezimalpunkt, wird der zu formatierende Wert auf die nächste ganze Zahl gerundet.

Wenn die zu formatierende Zahl links vom Dezimaltrennzeichen mehr Ziffern enthält, als es in der Formatzeichenfolge Platzhalter für Ziffern links vom „.“-Zeichen gibt, werden die zusätzlichen Ziffern vor dem ersten Ziffernplatzhalter ausgegeben.

Um unterschiedliche Formatierungen für positive, negative und Nullwerte zu ermöglichen, kann die Formatzeichenfolge zwischen einem und drei durch Semikolons getrennte Abschnitte enthalten.

Ein Abschnitt: Die Formatzeichenfolge gilt für alle Werte.

Zwei Abschnitte: Der erste Abschnitt gilt für positive Werte und Nullen, der zweite Abschnitt gilt für negative Werte.

Drei Abschnitte: Der erste Abschnitt gilt für positive Werte, der zweite für negative Werte und der dritte für Nullen.

Ist der Abschnitt für negative Werte oder der Abschnitt für Nullwerte leer, d. h. befindet sich nichts zwischen den Semikolons, die den Abschnitt begrenzen, wird stattdessen der Abschnitt für positive Werte verwendet.

Ist der Abschnitt für positive Werte leer oder ist die gesamte Formatzeichenfolge leer, wird der Wert nach der allgemeinen Gleitkommaformatierung mit 15 signifikanten Stellen formatiert, was einem Aufruf von FloatToStrF mit dem Format ffGeneral entspricht. Die allgemeine Gleitkommaformatierung wird auch verwendet, wenn der Wert mehr als 18 Stellen vor dem Dezimalpunkt hat und die Formatzeichenfolge keine wissenschaftliche Notation vorgibt. |