Funkcija date

Funkcija date izvada datumu norādītajā formātā. Pirmo parametru funkcija saņem formātu, bet otro neobligāto parametru - laika momentu timestamp formātā. Ja otrais parametrs nav norādīts - tiks ņemts pašreizējais laika moments, ja norādīts - tad norādītais.

Formāts tiek norādīts ar vadības komandām (angļu burtiem), savukārt starp tām var ievietot jebkurus atdalītājus (domuzīmes, kolu un tā tālāk).

Funkcija pieņem šādas komandas (lielie burti atšķiras no mazajiem, pievērsiet uzmanību):

U – sekunžu skaits, kas pagājis kopš 1. janvāra 1970. gada (tas ir, timestamp).
z – dienas numurs kopš gada sākuma.
Y – gads, 4 cipari.
y - gads, divi cipari.
m – mēneša numurs (ar nulli priekšā).
n – mēneša numurs bez nulles priekšā.
d – dienas numurs mēnesī, vienmēr divi cipari (tas ir, pirmais var būt nulle).
j – dienas numurs mēnesī bez priekšā esošās nulles.
w – nedēļas diena (0 - svētdiena, 1 - pirmdiena utt.).
h – stundas 12-stundu formātā.
H – stundas 24-stundu formātā.
i – minūtes.
s – sekundes.
L – 1, ja garais gads, 0, ja nav garais gads.
W – kārtas numurs nedēļai gadā.
t – dienu skaits norādītajā mēnesī.

Sintakse

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

Darba piemēri ar date

<?php
	// Visi piemēri parādīti datumam 01.06.2013 plkst. 12.23.59, pirmdiena
	
	echo date('Y'); // izvadīs '2013'
	echo date('y'); // izvadīs '13'
	echo date('m'); // izvadīs '06' - mēneša numurs
	echo date('d'); // izvadīs '01' - dienas numurs mēnesī
	echo date('j'); // izvadīs '1'  - dienas numurs mēnesī (bez nulles priekšā)
	echo date('w'); // izvadīs '1'  - pirmdiena
	echo date('H'); // izvadīs '12' - stundas
	echo date('i'); // izvadīs '23' - minūtes
	echo date('s'); // izvadīs '59' - sekundes
	
	echo date('d-m-Y'); // izvadīs '01-06-2013'
	echo date('d.m.Y'); // izvadīs '01.06.2013'
	echo date('H:i:s d.m.Y'); // izvadīs '12:23:59 01.06.2013'
?>

Funkcijas date otrais parametrs

Funkcijai date ir otrais neobligātais parametrs, kas saņem laika momentu timestamp formātā. Ja padod šo parametru, tad funkcija date formatēs ne pašreizējo laika momentu, bet to, kas ticis padots otrajā parametrā. Šo timestamp var iegūt, piemēram, ar mktime (bet ne obligāti):

<?php
	echo date('d-m-Y', mktime(0, 0, 0, 12, 29, 13)); // izvadīs '29-12-2013'
?>

To var izmantot, lai uzzinātu nedēļas dienas numuru konkrētam datumam - vienkārši padod to otrajā parametrā ar funkcijas mktime palīdzību, bet pirmajā parametrā ieliekam vadības simbolu 'w':

<?php
	// Uzzināsim kāda nedēļas diena bija 29-12-2013:
	echo date('w', mktime(0, 0, 0, 12, 29, 13)); // izvadīs '0' - svētdiena
?>

Skatiet arī

funkciju mktime,
kas atgriež laika momentu timestamp formātā