Funkcija date

Funkcija date išveda datą nurodytu formatu. Pirmu parametru funkcija priima formatą, o antru pasirinktiniu parametru - laiko momentą timestamp formatu. Jei antras parametras nenurodytas - bus paimtas dabartinis laiko momentas, jei nurodytas - tai nurodytas.

Formatas nurodomas valdymo komandomis (anglų raidėmis), tuo tarpu galima įterpti bet kokius skiriamuosius ženklus tarp jų (brūkšnelius, dvitaškį ir pan.).

Funkcija priima šias komandas (didžiosios raidės skiriasi nuo mažųjų, atkreipkite dėmesį):

U – sekundžių skaičius, praėjęs nuo 1 sausio 1970 metų (tai yra timestamp).
z – metų dienos numeris.
Y – metai, 4 skaitmenys.
y - metai, du skaitmenys.
m – mėnesio numeris (su nuliu priekyje).
n – mėnesio numeris be priekyje esančio nulio.
d – mėnesio dienos numeris, visada du skaitmenys (tai yra pirmasis gali būti nulis).
j – mėnesio dienos numeris be priešakyje esančio nulio.
w – savaitės diena (0 - sekmadienis, 1 - pirmadienis ir t.t.).
h – valandos 12-valandų formatu.
H – valandos 24-valandų formatu.
i – minutės.
s – sekundės.
L – 1, jei keliamieji metai, 0, jei ne keliamieji.
W – eilinis metų savaitės numeris.
t – dienų skaičius nurodytą mėnesį.

Sintaksė

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

Pavyzdžiai su date

<?php
	// Visi pavyzdžiai rodomi datai 01.06.2013 12.23.59, pirmadienis
	
	echo date('Y'); // išves '2013'
	echo date('y'); // išves '13'
	echo date('m'); // išves '06' - mėnesio numeris
	echo date('d'); // išves '01' - mėnesio dienos numeris
	echo date('j'); // išves '1'  - mėnesio dienos numeris (be nulio priekyje)
	echo date('w'); // išves '1'  - pirmadienis
	echo date('H'); // išves '12' - valandos
	echo date('i'); // išves '23' - minutės
	echo date('s'); // išves '59' - sekundės
	
	echo date('d-m-Y'); // išves '01-06-2013'
	echo date('d.m.Y'); // išves '01.06.2013'
	echo date('H:i:s d.m.Y'); // išves '12:23:59 01.06.2013'
?>

Antras funkcijos date parametras

Funkcija date turi antrą pasirinktinį parametrą, kuris priima laiko momentą timestamp formatu. Jei perduosite šį parametrą, tai funkcija date suformatuos ne dabartinį laiko momentą, o tą, kuris perduotas antru parametru. Šį timestamp galima gauti, pavyzdžiui, per mktime (bet nebūtinai):

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

Tai galima panaudoti, norint sužinoti savaitės dienos numerį už tam tikrą datą - tiesiog perduokime ją antru parametru su pagalba funkcijos mktime, o pirmu parametru padėkime valdymo simbolį 'w':

<?php
	// Sužinokime kokia savaitės diena buvo 29-12-2013:
	echo date('w', mktime(0, 0, 0, 12, 29, 13)); // išves '0' - sekmadienis
?>

Taip pat žiūrėkite

funkciją mktime,
kuri grąžina laiko momentą timestamp formatu