Date функцияси

date функцияси берилган форматда санани чиқаради. Биринчи параметр сифатида функция форматни қабул қилади, иккинчи ихтиёрий параметр сифатида эса - timestamp форматидаги вақт муддати. Агар иккинчи параметр кўрсатилмаган бўлса - жорий вақт муддати олинади, агар кўрсатилган бўлса - берилган.

Формат бошқарув buyruqlari (инглиз ҳарфлари) орқали берилади, бу ҳолда улар ўртасига ҳар қандай ажратиш белгиларини (дефис, қос нуқта ва ҳоказо) қўйиш мумкин.

Функция қуйидаги buyruqlarni қабул қилади (бош ҳарфлар оддийлардан фарқ қилади, эътибор беринг):

U – 1970 йил 1 январдан бери ўтган сониялар сони (яъни 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 форматидаги вақт муддатини қайтаради