A date függvény

A date függvény egy adott formátumban jeleníti meg a dátumot. A függvény első paramétereként a formátumot, második, opcionális paramétereként pedig az időpillanatot fogadja timestamp formátumban. Ha a második paraméter nincs megadva - az aktuális időpillanat lesz felhasználva, ha meg van adva - akkor a megadott.

A formátumot vezérlő karakterekkel (angol betűkkel) adjuk meg, bármilyen elválasztó karaktert használhatunk közöttük (kötőjelet, kettőspontot stb.).

A függvény a következő vezérlőkaraktereket fogadja (a nagybetűk eltérnek a kisbetűktől, figyelj erre):

U – az eltelt másodpercek száma 1 január 1970 óta (azaz timestamp).
z – az év napjának sorszáma (az év elejétől).
Y – év, 4 számjeggyel.
y - év, két számjeggyel.
m – a hónap sorszáma (előtte nullával).
n – a hónap sorszáma előtte nélküli nullával.
d – a hónap napjának sorszáma, mindig két számjegy (azaz az első lehet nulla).
j – a hónap napjának sorszáma előtte nélküli nullával.
w – a hét napja (0 - vasárnap, 1 - hétfő stb.).
h – óra 12-órás formátumban.
H – óra 24-órás formátumban.
i – perc.
s – másodperc.
L – 1, ha szökőév, 0, ha nem szökőév.
W – az év hetének sorszáma.
t – a megadott hónap napjainak száma.

Szintaxis

date(string $format, ?int $timestamp = null): string

Példák a date használatára

<?php
	// Minden példa a 2013.06.01 - 12:23:59, hétfő dátumra/dátumidejre vonatkozik
	
	echo date('Y'); // kiírja '2013'
	echo date('y'); // kiírja '13'
	echo date('m'); // kiírja '06' - a hónap sorszáma
	echo date('d'); // kiírja '01' - a hónap napjának sorszáma
	echo date('j'); // kiírja '1'  - a hónap napjának sorszáma (előtte nélküli nullával)
	echo date('w'); // kiírja '1'  - hétfő
	echo date('H'); // kiírja '12' - óra
	echo date('i'); // kiírja '23' - perc
	echo date('s'); // kiírja '59' - másodperc
	
	echo date('d-m-Y'); // kiírja '01-06-2013'
	echo date('d.m.Y'); // kiírja '01.06.2013'
	echo date('H:i:s d.m.Y'); // kiírja '12:23:59 01.06.2013'
?>

A date függvény második paramétere

A date függvénynek van egy második, opcionális paramétere, amely az időpillanatot fogadja timestamp formátumban. Ha átadjuk ezt a paramétert, akkor a date függvény nem az aktuális időpillanatot, hanem a második paraméterként átadottat formázza. Ezt a timestamp-et lehet például a mktime függvénnyel megkapni (de nem feltétlenül):

<?php
	echo date('d-m-Y', mktime(0, 0, 0, 12, 29, 13)); // kiírja '29-12-2013'
?>

Ezt kihasználhatjuk, hogy megtudjuk egy adott dátum hetének napját - egyszerűen átadjuk azt a második paraméterként a mktime függvény segítségével, az első paraméternek pedig a 'w' vezérlőkaraktert állítjuk be:

<?php
	// Nézzük meg, milyen nap volt 2013.12.29:
	echo date('w', mktime(0, 0, 0, 12, 29, 13)); // kiírja '0' - vasárnap
?>

Lásd még

a mktime függvényt,
amely timestamp formátumban adja vissza az időpillanatot