Funkcija date

Funkcija date izpiše datum v dani obliki. Prvi parameter funkcije sprejme obliko, drugi neobvezni parameter pa - trenutek časa v formatu timestamp. Če drugi parameter ni določen, se vzame trenutni trenutek časa, če je določen, pa določeni.

Oblika je določena z ukaznimi znaki (angleškimi črkami), med njih pa lahko vstavljate poljubne ločila (črtice, dvopičje in tako naprej).

Funkcija sprejme naslednje ukaze (velike črke se razlikujejo od običajnih, bodite pozorni):

U – število sekund, pretečenih od 1 januarja 1970 leta (to je timestamp).
z – številka dneva od začetka leta.
Y – leto, 4 številke.
y - leto, dve številki.
m – številka meseca (z ničlo spredaj).
n – številka meseca brez ničle spredaj.
d – številka dneva v mesecu, vedno dve številki (to je prva je lahko ničla).
j – številka dneva v mesecu brez predhodne ničle.
w – dan v tednu (0 - nedelja, 1 - ponedeljek itd.).
h – ure v 12-urnem formatu.
H – ure v 24-urnem formatu.
i – minute.
s – sekunde.
L – 1, če je prestopno leto, 0, če ni prestopno.
W – zaporedna številka tedna v letu.
t – število dni v navedenem mesecu.

Sintaksa

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

Primeri delovanja date

<?php
	// Vsi primeri so prikazani za datum 01.06.2013 ob 12.23.59, ponedeljek
	
	echo date('Y'); // izpiše '2013'
	echo date('y'); // izpiše '13'
	echo date('m'); // izpiše '06' - številka meseca
	echo date('d'); // izpiše '01' - številka dneva v mesecu
	echo date('j'); // izpiše '1'  - številka dneva v mesecu (brez ničle spredaj)
	echo date('w'); // izpiše '1'  - ponedeljek
	echo date('H'); // izpiše '12' - ure
	echo date('i'); // izpiše '23' - minute
	echo date('s'); // izpiše '59' - sekunde
	
	echo date('d-m-Y'); // izpiše '01-06-2013'
	echo date('d.m.Y'); // izpiše '01.06.2013'
	echo date('H:i:s d.m.Y'); // izpiše '12:23:59 01.06.2013'
?>

Drugi parameter funkcije date

Funkcija date ima drugi neobvezni parameter, ki sprejme trenutek časa v formatu timestamp. Če posredujete ta parameter, bo funkcija date formatirala ne trenutni trenutek časa, ampak tistega, ki je posredovan z drugim parametrom. Ta timestamp je mogoče dobiti, na primer, prek mktime (vendar ni nujno):

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

Tega lahko izkoristimo, da ugotovimo številko dneva v tednu za določen datum - preprosto ga posredujemo z drugim parametrom s pomočjo funkcije mktime, s prvim parametrom pa nastavimo ukazni znak 'w':

<?php
	// Ugotovimo, kateri dan v tednu je bil 29-12-2013:
	echo date('w', mktime(0, 0, 0, 12, 29, 13)); // izpiše '0' - nedelja
?>

Glejte tudi

funkcijo mktime,
ki vrne trenutek časa v formatu timestamp