Funkce date

Funkce date vypisuje datum v zadaném formátu. Prvním parametrem funkce přijímá formát, a druhým volitelným parametrem - časový okamžik ve formátu timestamp. Pokud druhý parametr není uveden - vezme se aktuální časový okamžik, pokud je uveden - tak zadaný.

Formát se zadává řídícími příkazy (anglickými písmeny), přičemž lze vkládat libovolné oddělovače mezi nimi (pomlčky, dvojtečku a tak dále).

Funkce přijímá následující příkazy (velká písmena se liší od obyčejných, věnujte pozornost):

U – počet sekund, které uplynuly od 1 ledna 1970 roku (tedy timestamp).
z – číslo dne od začátku roku.
Y – rok, 4 číslice.
y - rok, dvě číslice.
m – číslo měsíce (s nulou na začátku).
n – číslo měsíce bez nuly na začátku.
d – číslo dne v měsíci, vždy dvě číslice (tedy první může být nula).
j – číslo dne v měsíci bez úvodní nuly.
w – den v týdnu (0 - neděle, 1 - pondělí atd.).
h – hodiny ve 12hodinovém formátu.
H – hodiny ve 24hodinovém formátu.
i – minuty.
s – sekundy.
L – 1, pokud je přestupný rok, 0, pokud není přestupný.
W – pořadové číslo týdne v roce.
t – počet dnů v uvedeném měsíci.

Syntaxe

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

Příklady práce s date

<?php
	// Všechny příklady jsou uvedeny pro datum 01.06.2013 ve 12.23.59, pondělí
	
	echo date('Y'); // vypíše '2013'
	echo date('y'); // vypíše '13'
	echo date('m'); // vypíše '06' - číslo měsíce
	echo date('d'); // vypíše '01' - číslo dne v měsíci
	echo date('j'); // vypíše '1'  - číslo dne v měsíci (bez nuly na začátku)
	echo date('w'); // vypíše '1'  - pondělí
	echo date('H'); // vypíše '12' - hodiny
	echo date('i'); // vypíše '23' - minuty
	echo date('s'); // vypíše '59' - sekundy
	
	echo date('d-m-Y'); // vypíše '01-06-2013'
	echo date('d.m.Y'); // vypíše '01.06.2013'
	echo date('H:i:s d.m.Y'); // vypíše '12:23:59 01.06.2013'
?>

Druhý parametr funkce date

Funkce date má druhý volitelný parametr, který přijímá časový okamžik ve formátu timestamp. Pokud předáte tento parametr, funkce date naformátuje nikoli aktuální časový okamžik, ale ten, který je předán druhým parametrem. Tento timestamp lze získat, kupříkladu, pomocí mktime (ale ne nutně):

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

Toho lze využít, abychom zjistili číslo dne v týdnu pro určité datum - jednoduše jej předáme druhým parametrem pomocí funkce mktime, a jako první parametr nastavíme řídící znak 'w':

<?php
	// Zjistíme, který den v týdnu byl 29-12-2013:
	echo date('w', mktime(0, 0, 0, 12, 29, 13)); // vypíše '0' - neděle
?>

Viz také

funkci mktime,
která vrací časový okamžik ve formátu timestamp