ANHANG E: Konstanten und Funktionen der vbcompat.bi
vbcompat.bi bindet weitere Dateien ein, welche Funktionalitäten mit Kompatibilität zu Visual Basic bereit stellen:
-
datetime.bi: Funktionen und Konstanten zur Berechnung von Datum und Zeit
-
string.bi: Funktion
FORMAT
-
dir.bi: Konstanten zur Benutzung mit
DIR
-
file.bi: Funktionen und Konstanten zum Umgang mit Dateien
E.1 Datum und Zeit
E.1.1 Verfügbare Funktionen
-
DATESERIAL
-
wandelt eine Datumsangabe in eine Serial Number um
-
DATEVALUE
-
wandelt einen Datums-String in eine Serial Number um
-
ISDATE
-
überprüft, ob ein String ein gültiges Datum darstellt
-
YEAR
-
gibt das Jahr einer Serial Number zurück
-
MONTH
-
gibt den Monat einer Serial Number zurück
-
DAY
-
gibt den Tag des Jahres einer Serial Number zurück
-
WEEKDAY
-
gibt den Tag der Woche einer Serial Number zurück
-
TIMESERIAL
-
wandelt eine Zeitangabe in eine Serial Number um
-
TIMEVALUE
-
wandelt einen Zeit-String in eine Serial Number um
-
HOUR
-
gibt die Stunde einer Serial Number zurück
-
MINUTE
-
gibt die Minute einer Serial Number zurück
-
SECOND
-
gibt die Sekunde einer Serial Number zurück
-
NOW
-
gibt die Serial Number des aktuellen Zeitpunkts zurück
-
DATEADD
-
addiert ein bestimmtes Zeitintervall zu einer Serial Number
-
DATEPART
-
gibt eine Teilinformation zu einer Serial Number zurück
-
DATEDIFF
-
gibt die Differenz zwischen zwei Serial Numbers zurück
-
MONTHNAME
-
gibt den Monatsnamen einer Zahl (1-12) zurück
-
WEEKDAYNAME
-
gibt den Wochennamen einer Zahl (1-7) zurück
E.1.2 Definierte Konstanten
Für WEEKDAY()
, WEEKDAYNAME()
, DATEPART()
und DATEDIFF()
kann der Wochentag angegeben werden, an dem die Woche beginnt. Wird er nicht angegeben, verwendet FreeBASIC stattdessen fbUseSystem.
-
fbUseSystem
: Verwende das lokal eingestellte System. -
fbSunday
,fbMonday
,fbTuesday
,fbWednesday
,fbThursday
,fbFriday
,fbSaturday
: Die Woche beginnt mit Sonntag, Montag, …
Für DATEPART()
und DATEDIFF()
kann die Woche angegeben werden, mit der das Jahr beginnt. Wird sie nicht angegeben, verwendet FreeBASIC stattdessen fbUseSystem.
-
fbUseSystem
: Verwende das lokal eingestellte System. -
fbFirstJan1
: Beginne mit der Woche des ersten Januar. -
fbFirstFourDays
: Beginne mit der ersten Woche, die mindestens vier Tage hat. -
fbFirstFullWeek
: Beginne mit der ersten ganzen Woche des Jahres.
\newpage
Für DATEADD()
, DATEPART()
und DATEDIFF()
muss ein Intervall angegeben werden. Die drei Funktionen verwenden weitestgehend dieselben Optionen, die sich jedoch in Einzelfällen unterscheiden.
-
"yyyy": Jahre
-
"q": Quartale (drei Monate)
-
"m": Monate
-
"ww": Wochen
FürDATEPART
undDATEDIFF
sind damit die Kalenderwochen gemeint (abhängig von der Einstellung für die erste Woche des Jahres bzw. den ersten Tag der Woche). -
"w": abhängig von der Funktion.
FürDATEPART
: Tag innerhalb der Woche
FürDATEDIFF
: Sieben-Tage-Einheiten (Wochen)
FürDATEADD
: Tage -
"d": Tage
FürDATEPART
ist der Tag innerhalb des Monats gemeint. -
"y": Tage
FürDATEPART
ist der Tag innerhalb des Jahres gemeint. -
"h": Stunden
-
"n": Minuten
-
"s": Sekunden
\newpage
E.2 Formatierungsmöglichkeiten durch FORMAT()
Die Funktion FORMAT()
erlaubt die formatierte Ausgabe einer Zahl. Die Ausgabe wird durch die im Formatstring enthaltenen Zeichen und Zeichenfolgen festgelegt.
|
Platzhalter für eine Ziffer; Auffüllung mit führenden Nullen |
Nach dem Dezimaltrennzeichen werden so viele Ziffern dargestellt wie angegeben. |
|
|
Platzhalter für eine Ziffer; ohne führenden Nullen |
|
Platzhalter für ein Dezimaltrennzeichen |
|
Der Ausdruck wird mit 100 multipliziert und mit einem Prozent-Zeichen |
|
Platzhalter für Tausendertrennzeichen. Zwei aufeinanderfolgende Kommata bewirken das |
Auslassen der drei Ziffern zwischen den Kommata; die Zahl wird dabei korrekt gerundet. |
|
|
Wissenschaftliches Format; nur negatives Vorzeichen des Exponenten anzeigen |
|
Wissenschaftliches Format; Vorzeichen des Exponenten immer anzeigen |
|
Literale; werden so ausgegeben, wie sie im Formatierungsstring stehen. |
|
Nächstes Zeichen im Formatierungsstring als Literal ausgeben (also nicht interpretiert). |
|
Text wird so ausgegeben, wie er im Formatierungsstring steht. |
|
Datumstrennzeichen zur Trennung von Tagen, Monaten und Jahren |
|
Tag als Zahl ohne führende Null ( |
|
Tag als Zahl mit führender Null ( |
|
Tag als Abkürzung seines Namens ( |
|
Tag als vollen Namen an ( |
|
Datum als vollständiges Datum, einschließlich Tag, Monat und Jahr* |
|
Monat als Zahl ohne führende Null ( |
|
Monat als Zahl mit führender Null ( |
|
Monat als Zahl ohne bzw. mit führender Null |
|
Monat als Abkürzung seines Namens ( |
|
Monat als vollen Namen an ( |
|
Jahr als zweistellige Zahl ( |
|
Jahr als vierstellige Zahl ( |
|
Stunde ohne führende Null ( |
|
Stunde mit führender Null ( |
|
Minute ohne führender Null ( |
|
Minute mit führender Null ( |
|
Sekunde ohne führende Null ( |
|
Sekunde mit führender Null ( |
|
komplette Uhrzeit mit Stunde, Minute und Sekunde* |
|
Zeit im 12-Stunden-Format mit |
|
Zeit im 12-Stunden-Format mit |
* Die Anzeige hängt von den Systemeinstellungen ab.
** Wenn m
bzw. mm
direkt auf h
oder hh
folgt, zeigt es stattdessen die Minuten an.
\newpage
E.3 Konstanten für die Attribute von DIR
-
fbReadOnly
: Zeige schreibgeschützte Dateien an. -
fbHidden
: Zeige versteckte Dateien an. -
fbSystem
: Zeige Systemdateien an. -
fbDirectory
: Zeige Verzeichnisse an -
fbArchive
: Zeige archivierbare Dateien an. -
fbNormal
=fbReadOnly
OR
fbArchive
E.4 Dateifunktionen
E.4.1 Verfügbare Funktionen
-
FILECOPY
-
kopiert eine Datei
-
FILEATTR
-
liefert Informationen über eine geöffnete Datei
-
FILELEN
-
gibt die Länge einer Datei zurück
-
FILEEXISTS
-
prüft, ob eine Datei existiert
-
FILEDATETIME
-
gibt das letzte Änderungsdatum einer Datei zurück
E.4.2 Definierte Konstanten
Durch FILEATTR
abfragbare Daten:
fbFileAttrMode
, fbFileAttrHandle
, fbFileAttrEncoding
Rückgabewerte von fbFileAttrMode
:
fbFileModeInput
, fbFileModeOutput
, fbFileModeRandom
,
fbFileModeAppend
, fbFileModeBinary
Rückgabewerte von fbFileAttrEncoding
:
fbFileEncodASCII
, fbFileEncodUTF8
, fbFileEncodUTF16
,
fbFileEncodUTF32