(PHP 4, PHP 5)
date — Formatează data/timpul local
Returnează un şir formatat conform cu formatul transmis ca parametru al funcţiei, utilizând întregul timestamp sau timpul local dacă nu este utilizat parametrul timestamp .
Notă: Perioada validă a timestamp este cuprinsă, de regulă, între vineri, 13 Decembrie 1901 20:45:54 GMT şi marţi, 19 ianuarie 2038 03:14:07 GMT. (Acestea sunt datele care corespund minimului, respectiv maximului unui întreg cu semn reprezentat pe 32 de biţi.)
Pentru a genera un timestamp dintr-un şir reprezentând o dată, puteţi utiliza funcţia strtotime(). De asemenea, unele sisteme de gestiune a bazelor de date au funcţii care pot converti formatul lor de dată în timestamps (cum ar fi funcţia MySQL UNIX_TIMESTAMP).
Următoarele caractere sunt recunoscute în şirul format :
Example#1 Exemplu date()
echo date ("l dS of F Y h:i:s A");
echo "July 1, 2000 este într-o zi de " . date ("l", mktime(0,0,0,7,1,2000));
Puteţi preveni expandarea unui caracter de formatare precedându-l cu un backslash. Dacă astfel ia naştere un caracter escape predefinit este necesară adăugarea încă unui backslash.
Example#2 Caractere escape în funcţia date()
echo date("l \e\s\\t\e \i\\n j"); // va afişa ceva de genul 'Saturday este in 8'
Este posibil să utilizaţi funcţiile date() şi mktime() împreună pentru a găsi date în viitor sau în trecut.
Example#3 Exemplu date() şi mktime()
$miine = mktime (0,0,0,date("m") ,date("d")+1,date("Y"));
$luna_trecuta = mktime (0,0,0,date("m")-1,date("d"), date("Y"));
$anul_viitor = mktime (0,0,0,date("m"), date("d"), date("Y")+1);
Notă: Această modalitate de găsire a datelor din trecut sau viitor este mai demnă de încredere decât simpla adăugare sau scădere de secunde la un timestamp, datorită orei de vară.
Câteva exemple de formatare a datei utilizând funcţia date(). Este recomandat să faceţi escape la toate caracterele din şirul de formatare pe care nu doriţi ca funcţia să le expandeze, precum şi la cele care momentan nu au o semnificaţie, din cel puţin două motive: pot apărea rezultate neaşteptate; alte caractere pot avea o semnificaţie în versiuni viitoare ale PHP. Când faceţi escape ţineţi cont că unele caractere (n, t) capătă semnificaţii speciale. Pentru a preveni acest lucru utilizaţi apostroful pentru încadrarea şirului de formatare.
Example#4 Formatare cu funcţia date()
/* Today is March 10th, 2001, 5:16:18 pm */
$azi = date("F j, Y, g:i a"); // March 10, 2001, 5:16 pm
$azi = date("m.d.y"); // 03.10.01
$azi = date("j, n, Y"); // 10, 3, 2001
$azi = date("Ymd"); // 20010310
$azi = date('h-i-s, j-m-y, it is w Day z '); // 05-16-17, 10-03-01, 1631 1618 6 Fripm01
$azi = date('\e\s\t\e \z\i\u\a \d\e j.'); // este ziua de 10.
$azi = date("D M j G:i:s T Y"); // Sat Mar 10 15:16:08 MST 2001
$azi = date('H:m:s \l \e\s\t\e \l\u\n\a'); // 17:03:17 l este luna
$azi = date("H:i:s"); // 17:16:17
Pentru a formata datele în alte limbi trebuie să utilizaţi funcţiile setlocale() şi strftime().
Vezi, de asemenea, getlastmod(), gmdate(), mktime(), strftime() şi time().