Die folgenden Funktionen habe ich erst sehr spät entdeckt. Leider werden sie auch mit keinem Wort in der Klasse TDateTime erwähnt, noch sind sie Bestandteile der Klasse. Letzteres empfinde ich als ausgesprochen ärgerlich. Schließlich will man ja mal mit einem Datum rechnen. Zwar hat die Klasse diverse Operatoren überlagert, aber das ist meist nicht das was mal gerade braucht.

Zu beachten ist, dass für alle Funktionen die

#include <DateUtils.hpp>

includiert wird.

Hier nun die Funktionen, die einen doch ein bisschen Arbeit abnehmen:

• IncMilliSecond
• IncSecond
• IncMinute
• IncHour
• IncDay
• IncWeek
• IncMonth
• IncYear

Diese Funktionen arbeiten alle gleich. Sie erwarten als Übergabeparameter ein TDateTime Objekt und einen Wert. Ist der Wert negativ wird zurückgerechnnet. Beispiel:

String ausgabe;
TDateTime dt=Now();
ausgabe=dt.DateTimeString(); //heutiges Datum
dt=IncYear(dt,-20);
ausgabe=dt.DateTimeString(); //vor 20 Jahren

Weiterhin gibt es Funktionen, die ein bestehendes Datum abändern. Dies sind:

• RecodeMilliSecond
• RecodeSecond
• RecodeMinute
• RecodeHour
• RecodeDay
• RecodeMonth
• RecodeYear

Diese Funktionen arbeiten alle gleich. Sie erwarten als Übergabeparameter ein TDateTime Objekt und einen Wert. Der Wert wird als neuer Bestandteil des TDateTime Objektes eingefügt. Beispiel:

String ausgabe;
TDateTime dt=Now();
ausgabe=dt.DateTimeString(); //heutiges Datum
dt=RecodeYear(dt,1890);
ausgabe=dt.DateTimeString(); //Jahr wird auf 1890 gesetzt.

Zusätzlich gibt es noch

• RecodeDate
• RecodeDateTime

mit denen ganze Daten und Zeitwerte auf einmal geändert werden können.

Weitere Funktionen (der Name dürfte sprechend sein):

Die Funktionen werden alle in der Hilfe erläutert.

Zur Übersicht