Die einfachste Funktion in Bezug auf Serial Numbers ist NOW(). Die Funktion gibt eine Serial Number zurück, die den aktuellen Zeitpunkt repräsentieren.

Das ist jetzt noch nicht besonders hilfreich. Glücklicherweise lässt sich der Wert auf recht einfache Weise in ein für Menschen lesbares Format übertragen. Wir greifen dazu auf die Funktion FORMAT() zurück, die auf vielfältige Weise zur Formatierung von Zahlenwerten eingesetzt werden kann. Bevor wir ins Detail gehen, hier ein paar Beispiele:

Wie Sie sehen, ist eine Aussage über „morgen“ sehr einfach zu treffen, indem Sie zum aktuellen Zeitpunkt lediglich 1 addieren.

Aus der kurzen Demonstration können Sie schon ein paar Details über den Formatierungsstring herauslesen. d wird offenbar als Tag interpretiert, yyyy als vierstellige Jahreszahl usw. Da m als Monatsnummer interpretiert wird, wurde n (bzw. hier nn) zur Anzeige der Minuten verwendet. Tatsächlich wird ein hinter einem h stehendes m ebenfalls als Minutenangabe interpretiert anstatt als Monatsnummer. Ich würde trotzdem zur Verwendung von n raten, damit Sie nicht in Schwierigkeiten geraten, wenn Sie einmal nur die Minuten und Sekunden anzeigen lassen wollen, ohne Stundenangabe.

Neben Datums- und Zeitformatierungen dient FORMAT() auch zu allgemeinen Zahlenformatierungen. Der Formatierungsstring wird dazu analysiert und bei Auftreten bestimmter Zeichen oder Zeichenkombinationen entsprechend interpretiert. Die Möglichkeiten sind, wie gesagt, sehr vielfältig, und sind bei Weitem nicht auf die Ausgabe von Zeit und Datum beschränkt. Eine Zusammenstellung der möglichen Formatierungsangaben finden Sie in Anhang E.2. Auf den folgenden Seiten werden aber noch ein paar weitere Beispiele zum Einsatz von FORMAT() auftauchen.

Sie können natürlich nicht nur die Serial Number des aktuellen Zeitpunkts ermitteln, sondern die zu jedem beliebigen Zeitpunkt. Dazu gibt es zwei Funktionen zur Bearbeitung einer Zeitangabe und zwei Funktionen für Datumsangaben. Eine Zeit-Serial enthält nur die Zeitangabe ohne Datum, d. h. ihr Wert ist immer kleiner als 1. Eine Datums-Serial dagegen enthält keine Zeitangabe, ist also immer ganzzahlig. Selbstverständlich können Sie eine Zeit-Serial und eine Datums-Serial durch einfache Addition zu einer kompletten Serial Number kombinieren.

Zum Ermitteln einer Zeit-Serial gibt es folgende zwei Funktionen:

Analog dazu gibt es folgende zwei Funktionen zur Bestimmung einer Datums-Serial:

Wenn Sie prüfen wollen, ob ein String eine gültige Datumsangabe enthält, können Sie ISDATE() verwenden. Die Funktion gibt -1 zurück, wenn ein wie bei DATEVALUE() angegebenes Datumsformat voliegt, und 0, wenn dies nicht der Fall ist.

Beachten Sie in diesem Beispiel die automatische Umwandlung der zu hohen Uhrzeitangabe. Außerdem hängt die Ausgabe der Wochen- und Monatsnamen von den Systemeinstellungen ab.

Um aus einer Serial Number bestimmte Informationen zu extrahieren, ist FORMAT nicht immer die einfachste Methode. Sie können dafür auf eine große Anzahl an Funktionen mit leicht zu merkenden Namen zurückgreifen:

die in der Serial Number gespeichert sind. Der Rückgabewert ist jeweils ein INTEGER.

Außerdem gibt es noch DATEPART(), um eine beliebige Teilinformation zu extrahieren. Mit der Funktion können die zuvor genannten Funktionen ersetzt werden, aber auch weitere Informationen wie die Rückgabe der Kalenderwoche und des Quartals sind möglich.

Die durch WEEKDAY() und DATEPART() ermittelten Werte über den Tag der Woche und über die Kalenderwoche hängen davon ab, mit welchem Tag die Woche beginnt (üblich ist Sonntag oder Montag) bzw. mit welcher Woche die Zählung der Kalenderwoche beginnt. Dazu können beim Aufruf der Funktion weitere Angaben gemacht werden:

Intervall ist eine der in Quelltext 18.5 verwendeten Intervallangaben, Serial ist die Serial Number. Für erster_Tag_der_Woche kann eine der in der Datei datetime.bi definierten Konstanten verwendet werden:
fbUseSystem, fbSunday, fbMonday, fbTuesday, fbWednesday, fbThursday, fbFriday, fbSaturday
fbUseSystem verwendet das in den Systemeinstellungen festgelegte Verhalten, fbSunday legt den Sonntag als den ersten Tag der Woche fest, usw. Wird der Parameter ausgelassen, verwendet FreeBASIC die Systemeinstellungen.

Für erste_Woche_des_Jahres sind ebenfalls passende Konstanten definiert:

Auch hier wird standardmäßig das durch die Systemeinstellungen festgelegte Verhalten gewählt.

Die letzten beiden Funktionen im Zusammenhang mit dem Datum sind WEEKDAYNAME() und MONTHNAME(). Sie geben die Namen der Wochentage bzw. der Monate zurück. WEEKDAYNAME(1) liefert den Namen des ersten Wochentages, WEEKDAYNAME(7) entsprechend den Namen des letzten Wochentages. Für MONTHNAME() sind naürlich Parameterwerte von 1 bis 12 zulässig. Für Werte außerhalb des zugelassenen Bereichs wird ganz einfach ein Leerstring zurückgegeben.

Normalerweise liefern diese Funktionen den vollen Namen des Wochentages bzw. des Monats, also z. B. "Donnerstag" oder "August". Beide Funktionen erlauben aber auch die Ausgabe einer Kurzform wie "Do" oder "Aug". Dazu muss ein zweiter Parameter angegeben werden — ist dieser nicht 0, erfolgt die Ausgabe in Kurzform. Anders gesagt: Wenn Sie die Langform erhalten wollen, müssen Sie den zweiten Parameter 0 setzen oder gleich ganz weglassen.

WEEKDAYNAME() erlaubt außerdem einen dritten Parameter, um festzulegen, mit welchem Tag die Woche beginnt. Das funktioniert genauso wie bei DATEPART(). Wenn also etwa als dritter Parameter der Wert fbFriday angegeben wird, ist Freitag der erste Tag der Woche, der zweite Tag ist Samstag und die Woche endet am Donnerstag.

Beachten Sie auch bei diesen Funktionen, dass die Ausgabe (also insbesondere die Sprache, in der die Wochentage und Monate ausgegeben werden) von den Systemeinstellungen abhängt.

Für den zweiten Parameter von WEEKDAYNAME bzw. MONTHNAME hätte statt -1 auch jeder andere Wert ungleich 0 verwendet werden können. Ich verwende in solchen Situationen aber gern -1, weil es am deutlichsten den Wert wahr repräsentiert.

Da im unteren Codeabschnitt sowohl die Ermittlung der Wochentagsnummer als auch des Wochentagsnamens von Freitag an zu zählen beginnen, gleicht sich das im Endeffekt wieder aus, und Sie erhalten auch hier den korrekten Wochentagsnamen. In der vorletzten Zeile hätte statt des ausgelassenen mittleren Parameters natürlich auch 0 stehen können.

Serial Numbers können sehr einfach zum Berechnen von Zeitunterschieden und ähnlichem eingesetzt werden, allerdings halten die Zeitintervalle noch einige Schwierigkeiten bereit. So sind z. B. die Monate unterschiedlich lang, und auch bei Berechnungen mit Jahren müssen die Schaltjahre berücksichtigt werden. Glücklicherweise gibt es zwei Funktionen, welche die Rechenarbeit deutlich vereinfachen.

DATEADD() berechnet aus einer Serial Number ein neues Datum (wobei hier mit Datum immer die Kombination von Datum und Zeit gemeint ist), das aus der Addition eines bestimmten Zeitintervalls entsteht. Sie müssen dazu die gewünschte Intervall-Einheit sowie die Anzahl dieser Einheiten angeben.

Sie können also z. B. zum alten Datum zwei Wochen addieren, oder mit einer negativen Anzahl auch subtrahieren.

Um den Abstand zwischen zwei Datumsangaben zu bestimmen — also z. B. um herauszufinden, wie viele Wochen zwischen den beiden Angaben liegen — dient die Funktion DATEDIFF():

erster_Tag_der_Woche und erste_Woche_des_Jahres haben dieselbe Bedeutung wie bei DATEPART in Kapitel 18.3.3. Die Angabe des Intervalls in DATEADD() und DATEDIFF() ist der dort angegebenen Intervallangabe sehr ähnlich, weist jedoch kleine Unterschiede auf, die aus Tabelle 18.1 ersichtlich sind. Die Unterschiede erklären sich dadurch, dass in den drei Funktionen nicht immer alle Intervallangaben sinnvoll sind.

Bei Quartale handelt es sich, wie oben bereits erwähnt, um Einheiten von drei Monaten. Eine Woche ist eine Einheit von sieben Tagen, wogegen eine Kalenderwoche von der Einstellung des ersten Wochentags abhängig ist.

Ein paar Beispiele zu den beiden Funktionen:

Wie Sie sehen, gibt DATEDIFF() einen positiven Wert zurück, wenn das zweite Datum zeitlich nach dem ersten liegt, und ansonsten einen negativen Wert. Außerdem wurden die Schaltjahre bei beiden Funktionen korrekt berücksichtigt: Die Jahre 1904, 1908, 2000, 2004 und 2008 waren Schaltjahre, nicht jedoch das Jahr 1900 (da 1900 ohne Rest durch 100, aber nicht durch 400 teilbar ist). Schaltsekunden können von FreeBASIC allerdings nicht berücksichtigt werden, da diese aufgrund der Unregelmäßigkeiten in der Rotationsgeschwindigkeit der Erde nicht vorhersagbar sind.