Wer ist online?
Buchempfehlung
FreeBASIC-Chat
FreeBASIC-Nachrichten jetzt auch über Twitter erhalten. Follow us!Referenz - FORMAT
Syntax: FORMAT[$](numerischer_Ausdruck, FormatString)
Typ: Funktion
Kategorie: Stringfunktionen
Anmerkung:
Um diese Funktion nutzen zu können, muss die Datei vbcompat.bi in Ihren Quellcode eingebunden werden, z.B. mit 
INCLUDE.
FORMAT wandelt einen numerischen Ausdruck anhand der angegebenen Formatierung in einen STRING um.
- 'numerischer_Ausdruck' ist ein beliebiger Ausdruck, der als DOUBLE gehandhabt wird. Dies kann insbesondere auch eine Serial Number sein.
- 'FormatString' ist ein String, der festlegt, welche Form die Ausgabe haben soll. Er wird in den unten stehenden Tabellen näher erläutert.
Das Dollarzeichen ($) als Suffix ist optional.
Allgemeine Formatierungszeichen:
| Symbol | Erklärung |
|---|---|
| Nullstring | keine besondere Formatierung |
| 0 | Platzhalter für eine Ziffer. Wenn die auszugebende Zahl weniger Ziffern hat, als Platzhalter reserviert wurden, so werden diese mit führenden Nullen aufgefüllt. Nach dem Dezimaltrennzeichen werden so viele Ziffern dargestellt wie angegeben. Die Ziffern vor dem Dezimaltrennzeichen werden vollständig angezeigt, auch wenn im Formatierungsstring weniger Stellen angegeben werden. |
| # | Platzhalter für eine Ziffer. Funktioniert genauso wie 0, erzeugt aber keine führenden Nullen. |
| . | Platzhalter für ein Dezimaltrennzeichen. Wenn der Formatierungsstring nur Rauten (#) links vom Punkt (.) enthält, werden Zahlen, die kleiner als eins sind, ohne Null vor dem Komma ausgegeben. Das Dezimaltrennzeichen kann in den Ländereinstellungen eingestellt werden. |
| % | Der Ausdruck wird mit 100 multipliziert und mit einem Prozent-Zeichen (%) ausgegeben. |
| , | Platzhalter für Tausendertrennzeichen. Zwei aufeinanderfolgende Kommata oder ein Komma direkt links vom Dezimaltrennzeichen (egal ob die Position eines solchen angegeben wurde oder nicht) bewirken, dass die drei Ziffern zwischen den Kommata bzw. dem Komma und dem Punkt ausgelassen werden; die Zahl wird dabei korrekt gerundet. Das Tausendertrennzeichen kann in den Ländereinstellungen eingestellt werden. |
| E- E+ e- e+ | Wissenschaftliches Format: Die Zahl wird als Zehnerpotenz angegeben. Die Anzahl der Platzhalter für Ziffern (0 und #) links von E-, E+, e- oder e+ gibt dabei an, wie viele Stellen für die Darstellung der Zahl selbst reserviert werden; die Anzahl der Platzhalter rechts gibt an, wie viele Stellen für den Exponenten reserviert werden. E- und e- bewirken, dass das Vorzeichen des Exponenten nur angezeigt wird, wenn er negativ ist. E+ und e+ bewirken, dass das Vorzeichen des Exponenten sowohl angezeigt wird, wenn er positiv als auch wenn er negativ ist. |
| : ? + $ () Space | Literale: Diese Zeichen werden so ausgegeben, wie sie im Formatierungsstring stehen. Wenn Sie andere Zeichen als diese ausgeben wollen, müssen Sie einem einzelnen Zeichen einen Backslash (\) voranstellen oder die Zeichen in Anführungszeichen (") einschließen. Um einen Backslash auszugeben, müssen Sie also \\ oder "\" in Ihren Formatierungsstring einbauen. |
| \ | Das nächste Zeichen im Formatierungsstring wird als Literal ausgegeben. |
| "Text zwischen Anführungszeichen" | Der Text innerhalb der Anführungszeichen wird so ausgegeben, wie er im Formatierungsstring steht. |
| : | Der Doppelpunkt wird verwendet, um Stunden, Minuten und Sekunden voneinander zu trennen, wenn Zeitwerte formatiert werden. |
| / | Datumstrennzeichen: Der Schrägstrich wird verwendet, um Tage, Monate und Jahre voneinander zu trennen, wenn Datumswerte formatiert werden. In den Ländereinstellungen lässt sich einstellen, wie dieses Zeichen interpretiert werden soll. |
Datum/Zeit-Formatierungszeichen (bei Serial Numbers):
| Symbol | Erklärung |
|---|---|
| d | Zeige den Tag als Zahl ohne führende Null an (0-31) |
| dd | Zeige den Tag als Zahl mit führender Null an (00-31) |
| ddd | Zeige den Tag als Abkürzung seines Namens an (So-Sa)* |
| dddd | Zeige den Tag als vollen Namen an (Sonntag - Samstag)* |
| ddddd | Zeige das Datum als vollständiges Datum an, einschließlich Tag, Monat und Jahr* |
| m | Zeige den Monat als Zahl ohne führende Null an (1-12). Wenn 'm' direkt nach 'h' oder 'hh' benutzt wird, wird die Minute ohne führende Null angezeigt (0-59). |
| mm | Zeige den Monat als Zahl mit führender Null an (01-12). Wenn 'mm' direkt nach 'h' oder 'hh' benutzt wird, wird die Minute mit führender Null angezeigt (00-59). |
| M, MM | Zeige den Monat als Zahl ohne bzw. mit führender Null an (wie m und mm), jedoch auch dann, wenn es direkt nach 'h' oder 'hh' benutzt wird. |
| mmm | Zeige den Monat als Abkürzung seines Namens an (Jan-Dez)* |
| mmmm | Zeige den Monat als vollen Namen an (Januar-Dezember)* |
| y oder yy | Zeige das Jahr als zweistellige Zahl an (00-99) |
| yyyy | Zeige das Jahr als vierstellige Zahl an (1900-2040) |
| h | Zeige die Stunde ohne führende Null an (0-23) |
| hh | Zeige die Stunde mit führender Null an (00-23) |
| n | Zeige die Minute ohne führender Null an (wie m), jedoch auch wenn es nicht direkt hinter h oder hh verwendet wird. |
| nn | Zeige die Minute mit führender Null an (wie mm), jedoch auch wenn es nicht direkt hinter h oder hh verwendet wird. |
| s | Zeige die Sekunde ohne führende Null an (0-59) |
| ss | Zeige die Sekunde mit führender Null an (00-59) |
| ttttt | Zeige die komplette Uhrzeit mit Stunde, Minute und Sekunde an.* |
| AM/PM am/pm | Gib die Zeit als 12-Stunden-Zeit (00:00-11:59) mit AM bzw. am aus, wenn die Uhrzeit vor 12:00 liegt, und mit PM bzw. pm, wenn sie nach 12:00 liegt. |
| A/P a/p | Gib die Zeit als 12-Stunden-Zeit (00:00-11:59) mit A bzw. a aus, wenn die Uhrzeit vor 12:00 liegt, und mit P bzw. p, wenn sie nach 12:00 liegt. |
Hinweis: * Die Darstellung ist von den lokalen Ländereinstellungen abhängig.
Ausgabebeispiel:
Einfache Zahlenformatierung:
Formatstring 5 -5 .5 5000.5
Leerstring 5 -5 0,5 5000,5
0 5 -5 1 5000
0.00 5,00 -5,00 0,50 5000,50
#,##0 5 -5 1 5.000
#,##0.00 5,00 -5,00 0,50 5.000,00
$#,##0;($#,##0) $5 ($5) $1 $5.000
$#,##0.00;($#,##0.00) $5,00 ($5,00) $0,50 $5.000,00
0% 500% -500% 50% 500000%
0.00% 500,00% -500,00% 50,00% 500000.00%
0.00E+00 5,00E+00 -5,00E+00 5,00E-01 5,00E+03
0.00E-00 5,00E00 -5,00E00 5,00E-01 5,00E03
Zeitformatierung:
Formatstring Ausgabe
m/d/yy 12/7/58
d-mmmm-yy 7-Dezember-58
d-mmmm 7-Dezember
mmmm-yy Dezember-58
dddd Sonntag
ddddd 07.12.1958
h:mm AM/PM 8:50 PM
h:mm:ss AM/PM 8:50:35 PM
h:mm 20:50
h:mm:ss 20:50:35
m/d/yy h:mm 12/7/58 20:50
Unterschiede zu QB:
Diese Funktion existiert nur in QBX PDS und in VBDOS.
Unterschiede zu früheren Versionen von FreeBASIC:
- FORMAT existiert seit FreeBASIC v0.15
- Die Formatierungsangabe 'n' und 'nn' existiert seit FreeBASIC v0.21
Siehe auch:PRINT USING, STR, Serial Numbers, String-Funktionen
| Zusätzliche Informationen und Funktionen | ||||
|---|---|---|---|---|
|
||||
Versionen