Datumsfunktionen

SELFPHP

Praxisbuch

Datum- und Zeitfunktionen

sponsered by

Letztes Update: 16.08.2005 17:53:45

Navigation

News *

Startseite
Über SELFPHP
Werbung
Kontakt
Forum *
Download *
SELFPHP Banner *
SELFPHP in Buchform
Newsletter *
Impressum

* Link führt ins Internet

Anbieterverzeichnis

Informieren Sie sich über die Unternehmen in unserem Anbieterverzeichnis!

SELFPHP Forum

Fragen rund um die Themen PHP? In über 79.000 Beiträgen finden Sie sicher die passende Antwort!

Datumsfunktionen

Wichtiger als die Kalenderfunktionen sind allgemeine Datumsberechnungen. Die folgende Tabelle stellt die wichtigsten Datumsfunktionen zusammen.

Funktion	Beispiel	Beschreibung
checkdate($month,$day,$year)	checkdate(10,11,2004) => TRUE (1)	Gibt TRUE zurück, wenn das angegebene Datum korrekt ist. Benötigt drei Argumente für Monat, Tag und Jahr.
date("format",$timestamp)	date("d.M.Y") => 10.Jan.2004	Formatiert ein Datum.
getdate($timestamp)	getdate(mktime(0,0,0,1,1,2005))	Gibt ein assoziatives Array mit Datums- und Zeitangaben zurück.
gmdate("format",$timestamp)	gmdate("d.M.Y") => 10.Jan.2004	Wie date(), berücksichtigt jedoch GMT.

Hinweis: GMT ist die Kurzform für Greenwich Mean Time.

Für die Arbeit mit Daten ist oft das aktuelle Datum von grosser Bedeutung. Sie sollten hierbei jedoch beachten, dass der Server sich immer auf sein eigenes Systemdatum bezieht. Sollten Sie beispielsweise ihre Website in den USA hosten, wird das Ergebnis nicht unbedingt den Erwartungen entsprechen, vor allem dann nicht wenn Besucher aus Europa zeitabhängig begrüsst werden sollen.

Wenden wir uns nun den wichtigsten Datumsfunktionen und ihren Parametern zu.

Einsatz von getdate()

Die Funktion getdate() gibt ein assoziatives Array mit Datums- und Zeitangaben zurück. Das Array setzt sich aus folgenden Bestandteilen zusammen:

Schlüssel	Rückgabewerte (Beispiele)	Beschreibung
"seconds"	zwischen 0 und 59	Anzahl der Sekunden
"minutes"	zwischen 0 und 59	Anzahl der Minuten
"hours"	zwischen 0 und 23	Anzahl der Stunden
"mday"	zwischen 1 und 31	Numerischer Tag des Monats
"wday"	zwischen 0 (für Sonntag) und 6 (für Samstag)	Numerischer Wochentag
"mon"	zwischen 1 und 12	Monatszahl
"year"	Beispiele: 1999 oder 2003	Vierstellige Jahreszahl
"yday"	zwischen 0 und 366	Numerischer Tag des Jahres
"weekday"	zwischen Sonntag und Samstag	Ausgeschriebener Wochentag
"month"	zwischen Januar und Dezember	Ausgeschriebener Monatsname, wie Januar oder März
0	Abhängig vom System, typischerweise ein Wert zwischen -2147483648 und 2147483647.	Sekunden basierend auf dem Unix-Zeitcode, ähnlich den Werten die von der Funktion time() zurückgegeben und von der date() verwendet werden.

Beispiel



<pre>

<?php

print_r(getdate());

?>

</pre>

Ausgabe



Array

(

    [seconds] => 30

    [minutes] => 52

    [hours] => 22

    [mday] => 10

    [wday] => 6

    [mon] => 1

    [year] => 2004

    [yday] => 9

    [weekday] => Saturday

    [month] => January

    [0] => 1073771550

)

Beispiel - year



<?php

$zeit = getdate();

// Ausgabe (2004)

echo $zeit["year"];

?>

Einsatz von date()

Für die Darstellung eines Datums gibt es eine Vielzahl von Formatierungsmöglichkeiten. Die Funktion date() gibt ein Datum formatiert zurück, so dass Sie lokale Besonderheiten berücksichtigen können. Die Funktion benötigt zwei Argumente, eine Formatierungsanweisung und eine Zeitinformation als Unix-Zeitstempel. Sollte der zweite Parameter weg gelassen werden, wird die aktuelle Zeit verwendet.

Innerhalb der Formatieranweisung sind folgende Symbole von Bedeutung:

Symbol	Rückgabewerte (Beispiele)	Beschreibung
a	am oder pm	Kleingeschrieben: Ante meridiem und Post meridiem
A	AM oder PM	Großgeschrieben: Ante meridiem und Post meridiem
B	000 bis 999	Swatch-Internet-Zeit
d	01 bis 31	Tag des Monats, 2-stellig mit führender Null
D	Mon bis Sun	Tag der Woche als Abkürzung mit drei Buchstaben
F	January bis December	Monat als ganzes Wort.
g	1 bis 12	12-Stunden-Format, ohne führende Nullen
G	0 bis 23	24-Stunden-Format, ohne führende Nullen
h	01 bis 12	12-Stunden-Format, mit führenden Nullen
H	00 bis 23	24-Stunden-Format, mit führenden Nullen
i	00 bis 59	Minuten mit führenden Nullen
I (großes i)	1 bei Sommerzeit, ansonsten 0.	Fällt ein Datum in die Sommerzeit
j	1 bis 31	Tag des Monats ohne führende Nullen
l (kleines 'L')	Sunday bis Saturday	Ausgeschriebener Tag der Woche
L	1 für ein Schaltjahr, ansonsten 0.	Schaltjahr oder nicht
m	01 bis 12	Monat als Zahl, mit führenden Nullen
M	Jan bis Dec	Monatsname als Abkürzung mit drei Buchstaben
n	1 bis 12	Monatszahl, ohne führende Nullen
O	+0200	Zeitunterschied zur Greenwich Mea Time (GMT) in Stunden
r	Thu, 21 Dec 2000 16:01:07 +0200	RFC 822 formatiertes Datum
s	00 bis 59	Sekunden, mit führenden Nullen
S	st, nd, rd oder th. Zur Verwendung mit j empfohlen.	Anhang der englischen Aufzählung für einen Monatstag, zwei Zeichen
t	28 bis 31	Anzahl der Tage in einem Monat
T	Beispiele: EST, MDT ...	Zeitzoneneinstellung des Rechners
U	Siehe auch time()	Sekunden seit Beginn des UNIX-Zeitcodes (January 1 1970 00:00:00 GMT)
w	0 (für Sonntag) bis 6 (für Samstag)	Numerischer Tag einer Woche
W	Beispiel: 42 (die 42 Woche im Jahr)	ISO-8601 Wochennummer des Jahres, die Woche beginnt am Montag.
Y	Beispiel: 1999 oder 2003	Vierstellige Ausgabe der Jahreszahl
y	Beispiele: 99 oder 03	Zweistellige Ausgabe der Jahreszahl
z	0 bis 365	Der Tag eines Jahres
Z	-43200 bis 43200 (entspricht: -12 / +12 Stunden)	Offset der Zeitzone in Sekunden. Der Offset für Zeitzone West nach UTC ist immer negativ und für Zeitzone Ost nach UTC immer positiv.

Achtung: Sämtliche andere Zeichen werden ignoriert und unverändert zurückgegeben.

Beispiel



<?php

// Ausgabe 10.Jan.2004 23:14:16

echo date("d.M.Y H:i:s");

?>

Hinweis: Die Funktion gmdate() leistet das Gleiche, wie die Funktion date(), mit dem Unterschied, dass anstelle der lokalen Zeitzone GMT verwendet wird.

Kalenderfunktionen

Zeitfunktionen