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

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

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

php<?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<?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<?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