Buchempfehlung
Windows-Programmierung. Das Entwicklerhandbuch zur WIN32-API
Windows-Programmierung. Das Entwicklerhandbuch zur WIN32-API
"Der" Petzold, das über 1000 Seiten starke Standardwerk zum Win32-API - besonders nützlich u. a. bei der GUI-Programmierung in FreeBASIC! [Mehr Infos...]
FreeBASIC-Chat
Es sind Benutzer im FreeBASIC-Chat online.
(Stand:  )
FreeBASIC bei Twitter
Twitter FreeBASIC-Nachrichten jetzt auch über Twitter erhalten. Follow us!

Referenz - FORMAT

Referenz-Navigation

 

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 BefehlsreferenzeintragINCLUDE.

FORMAT wandelt einen numerischen Ausdruck anhand der angegebenen Formatierung in einen BefehlsreferenzeintragSTRING um.

Das Dollarzeichen ($) als Suffix ist optional.

Allgemeine Formatierungszeichen:

SymbolErklärung
Nullstringkeine besondere Formatierung
0Platzhalter 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.
: ? + $ () SpaceLiterale: 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):

SymbolErklärung
dZeige den Tag als Zahl ohne führende Null an (0-31)
ddZeige den Tag als Zahl mit führender Null an (00-31)
dddZeige den Tag als Abkürzung seines Namens an (So-Sa)*
ddddZeige den Tag als vollen Namen an (Sonntag - Samstag)*
dddddZeige das Datum als vollständiges Datum an, einschließlich Tag, Monat und Jahr*
mZeige 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).
mmZeige 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, MMZeige 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.
mmmZeige den Monat als Abkürzung seines Namens an (Jan-Dez)*
mmmmZeige den Monat als vollen Namen an (Januar-Dezember)*
y oder yyZeige das Jahr als zweistellige Zahl an (00-99)
yyyyZeige das Jahr als vierstellige Zahl an (1900-2040)
hZeige die Stunde ohne führende Null an (0-23)
hhZeige die Stunde mit führender Null an (00-23)
nZeige die Minute ohne führender Null an (wie m), jedoch auch wenn es nicht direkt hinter h oder hh verwendet wird.
nnZeige die Minute mit führender Null an (wie mm), jedoch auch wenn es nicht direkt hinter h oder hh verwendet wird.
sZeige die Sekunde ohne führende Null an (0-59)
ssZeige die Sekunde mit führender Null an (00-59)
tttttZeige die komplette Uhrzeit mit Stunde, Minute und Sekunde an.*
AM/PM am/pmGib 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/pGib 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:

Siehe auch:
BefehlsreferenzeintragPRINT USING, BefehlsreferenzeintragSTR, BefehlsreferenzeintragSerial Numbers, BefehlsreferenzeintragString-Funktionen


Zusätzliche Informationen und Funktionen
  • Der Referenzeintrag wurde am 29.07.2007 von Redakteurnemored angelegt.
  • Die aktuellste Version wurde am 27.12.2012 von Redakteurnemored gespeichert.
  Versionen Versionen