Функцыя date

Функцыя date выводзіць дату ў зададзеным фармаце. Першым параметрам функцыя прымае фармат, а другім неабавязковым параметрам - момант часу ў фармаце timestamp. Калі другі параметр не паказаны - возьмецца бягучы момант часу, калі паказаны - то зададзены.

Фармат задаецца кіруючымі камандамі (англійскімі літарамі), пры гэтым можна ўстаўляць любыя падзельнікі паміж імі (злучкі, двукроп’е і гэтак далей).

Функцыя прымае наступныя каманды (загалоўныя літары адрозніваюцца ад звычайных, звярніце ўвагу):

U – колькасць секунд, якія прайшлі з 1 студзеня 1970 года (гэта значыць timestamp).
z – нумар дня ад пачатку года.
Y – год, 4 лічбы.
y - год, дзве лічбы.
m – нумар месяца (з нулем спераду).
n – нумар месяца без нуля наперадзе.
d – нумар дня ў месяцы, заўсёды дзве лічбы (гэта значыць першая можа быць нулём).
j – нумар дня ў месяцы без папярэдняга нуля.
w – дзень тыдня (0 - нядзеля, 1 - панядзелак і г.д.).
h – гадзіны ў 12-гадзінным фармаце.
H – гадзіны ў 24-гадзінным фармаце.
i – хвіліны.
s – секунды.
L – 1, калі высакосны год, 0, калі не высакосны.
W – парадкавы нумар тыдня года.
t – колькасць дзён у паказаным месяцы.

Сінтаксіс

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

Прыклады работы з date

<?php
	// Усе прыклады паказаны для даты 01.06.2013 у 12.23.59, панядзелак
	
	echo date('Y'); // выведзе '2013'
	echo date('y'); // выведзе '13'
	echo date('m'); // выведзе '06' - нумар месяца
	echo date('d'); // выведзе '01' - нумар дня ў месяцы
	echo date('j'); // выведзе '1'  - нумар дня ў месяцы (без нуля спераду)
	echo date('w'); // выведзе '1'  - панядзелак
	echo date('H'); // выведзе '12' - гадзіны
	echo date('i'); // выведзе '23' - хвіліны
	echo date('s'); // выведзе '59' - секунды
	
	echo date('d-m-Y'); // выведзе '01-06-2013'
	echo date('d.m.Y'); // выведзе '01.06.2013'
	echo date('H:i:s d.m.Y'); // выведзе '12:23:59 01.06.2013'
?>

Другі параметр функцыі date

Функцыя date мае другі неабавязковы параметр, які прымае момант часу ў фармаце timestamp. Калі перадаць гэты параметр, то функцыя date адфарматуе не бягучы момант часу, а той, які перададзены другім параметрам. Гэты timestamp можна атрымаць, напрыклад, праз mktime (але не абавязкова):

<?php
	echo date('d-m-Y', mktime(0, 0, 0, 12, 29, 13)); // выведзе '29-12-2013'
?>

Гэтым можна скарыстацца, каб даведацца нумар дня тыдня за пэўную дату - проста перададзім яе другім параметрам з дапамогай функцыі mktime, а першым параметрам поставім кіруючы сімвал 'w':

<?php
	// Даведаемся які дзень тыдня быў 29-12-2013:
	echo date('w', mktime(0, 0, 0, 12, 29, 13)); // выведзе '0' - нядзеля
?>

Глядзіце таксама

функцыю mktime,
якая вяртае момант часу ў фармаце timestamp