Datumsfunktionen
Mit diesen Methoden der Date-Klasse ist das Berechnen beliebiger Datumsangaben möglich. Ausgehend von den übergebenen Parametern können Schaltjahre, Wochentage usw. genau ermittelt werden. Um die Methoden in Module einzubinden, muss die Datei "/functions/cp.date.php" per "include()" oder "include_once()" eingebunden werden.
Weitere Seiten:
Alternativ zur Methode "is_valid_date()" kann zur Überprüfung eines Datums die Methode "check_date()" eingesetzt werden. Diese nutzt intern die Funktion "checkdate()" von PHP. Für die Überprüfung wird der Methode ein Datum im Format TT.MM.YY bzw. TT.MM.YYYY übergeben. Mögliche Rückgabewerte sind "1" (true) und "0" (false).
$date->check_date("30.07.2005");
"days_per_month()" wird auch von anderen Datumsfunktionen eingesetzt und ermittelt die Anzahl der Tage in einem Monat in einem bestimmten Jahr. Dabei werden auch Schaltjahre mit beachtet. Der Rückgabewert ist die entsprechende Anzahl an Tagen.
$var = $date->days_per_month("4","2007");
Die Methode "first_monday()" ermittelt den Montag der ersten Kalenderwoche eines Jahres. Dieser muss allerdings nicht immer innerhalb des Jahres, d.h. im Januar, sondern kann auch im Dezember liegen (z.B. am 29.12. für das Jahr 2004). Die Methode erhält als einzigen Parameter ein Jahr übergeben (4-stellig). Wird dieser Parameter nicht übergeben, dann wird das aktuelle Jahr verwendet. Der Rückgabewert ist das Datum des ersten Montags des Jahres im Timestamp-Format.
$date->first_monday("2005");
"is_leap_year()" prüft, ob das übergebene Jahr ein Schaltjahr ist. Wird der Methode kein Jahr übergeben, so wird das aktuelle Jahr als Parameter genommen. Bei Erfolg gibt die Methode "true" zurück, andernfalls "false".
$var = $date->is_leap_year("2009");
Mit dieser Methode kann geprüft werden, ob ein Datum auch wirklich existiert. D.h. Tag, Monat und Jahr müssen vorhanden sein und bestimmte Begrenzungen einhalten (Tage pro Monat, Schaltjahr usw.). Der Methode "cp_valid_date()" werden hierzu Tag, Monat und Jahr übergeben. Als Ergebnis wird "true" oder "false" zurückgegeben.
$var = $date->is_valid_date("29","3","2003");
Weitere Seiten:
<< zurück zur Startseite der Dokumentation