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 ֆորմատով