Funktsioon date

Funktsioon date väljastab kuupäeva etteantud vormingus. Esimese parameetrina võtab funktsioon vormingu, ja teise valikulise parameetrina - ajahetke timestamp'i vormingus. Kui teist parameetrit ei määrata - võetakse praegune ajahetk, kui määratakse - siis etteantud.

Vorming määratakse juhtkäskude (inglise tähtedega), samas saab nende vahele panna suvalisi eraldajaid (kriipsud, koolon jne).

Funktsioon aktsepteerib järgmisi käske (suurtähed erinevad tavapärastest, pöörake tähelepanu):

U – sekundite arv, mis on möödunud 1. jaanuarist 1970 (st timestamp).
z – aasta päeva number (alustades 0-st).
Y – aasta, 4 numbrit.
y - aasta, kaks numbrit.
m – kuu number (eespool oleva nulliga).
n – kuu number ilma ees oleva nullita.
d – päeva number kuus, alati kaks numbrit (st esimene võib olla null).
j – päeva number kuus ilma eelneva nullita.
w – nädalapäev (0 - pühapäev, 1 - esmaspäev jne).
h – tunnid 12-tunnilises vormingus.
H – tunnid 24-tunnilises vormingus.
i – minutid.
s – sekundid.
L – 1, kui liigaasta, 0, kui mitte liigaasta.
W – aasta nädala järjekorranumber.
t – päevade arv määratud kuus.

Süntaks

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

Näited date'i kasutamisest

<?php
	// Kõik näited on näidatud kuupäeva 01.06.2013 kohta kell 12.23.59, esmaspäev
	
	echo date('Y'); // väljastab '2013'
	echo date('y'); // väljastab '13'
	echo date('m'); // väljastab '06' - kuu number
	echo date('d'); // väljastab '01' - päeva number kuus
	echo date('j'); // väljastab '1'  - päeva number kuus (ilma ees oleva nullita)
	echo date('w'); // väljastab '1'  - esmaspäev
	echo date('H'); // väljastab '12' - tunnid
	echo date('i'); // väljastab '23' - minutid
	echo date('s'); // väljastab '59' - sekundid
	
	echo date('d-m-Y'); // väljastab '01-06-2013'
	echo date('d.m.Y'); // väljastab '01.06.2013'
	echo date('H:i:s d.m.Y'); // väljastab '12:23:59 01.06.2013'
?>

Funktsiooni date teine parameeter

Funktsioonil date on teine valikuline parameeter, mis võtab ajahetke timestamp'i vormingus. Kui seda parameetrit edastada, siis funktsioon date vormindab mitte praeguse ajahetke, vaid selle, mis on edastatud teise parameetrina. Selle timestamp'i saab näiteks kätte funktsiooniga mktime (kuid mitte tingimata):

<?php
	echo date('d-m-Y', mktime(0, 0, 0, 12, 29, 13)); // väljastab '29-12-2013'
?>

Seda saab kasutada, et teada saada nädalapäeva number kindla kuupäeva kohta - lihtsalt edastame selle teise parameetrina abiga funktsioonist mktime, ja esimeseks parameetriks paneme juhtsümboli 'w':

<?php
	// Uurime, mis nädalapäev oli 29-12-2013:
	echo date('w', mktime(0, 0, 0, 12, 29, 13)); // väljastab '0' - pühapäev
?>

Vaata ka

funktsiooni mktime,
mis tagab ajahetke timestamp'i vormingus