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:
a - "am" sau "pm"
A - "AM" sau "PM"
B - timpul Swatch Internet
d - ziua din lună, 2 cifre cu zero inițial; de exemplu "01" to "31"
D - ziua din săptămână, în engleză, textual, 3 litere; de exemplu "Fri"
F - month, textual, long; de exemplu "January"
g - ora, format de 12 ore, fără zero inițial; de exemplu "1" până la "12"
G - ora, format de 24 de ore, fără zero inițial; de exemplu "0" până la "23"
h - ora, format 12 ore, cu zero inițial; de exemplu "01" până la "12"
H - ora, format 24 de ore, cu zero inițial; de exemplu "00" până la "23"
i - minute, cu zero inițial; de exemplu "00" până la "59"
I (litera i majusculă) - "1" ora de vară, "0" în caz contrar.
j - ziua din lună, fără zero inițial; de exemplu "1" până la "31"
l (litera 'L' minusculă) - ziua din săptămână, textual, în engleză, scurt; de exemplu "Friday"
L - valoare booleană pentru anii bisecți; de exemplu "0" dacă nu e an bisect sau "1" dacă este an bisect
m - luna, cu zero inițial; de exemplu "01" până la "12"
M - luna, textual, în engleză, 3 litere; de exemplu "Jan"
n - luna fără zero inițial; de exemplu "1" până la "12"
O - diferența până la ora Greenwich în ore; de exemplu "+0200"
r - data formatată conform recomandării RFC 822; de exemplu "Thu, 21 Dec 2000 16:01:07 +0200" (adăugată în PHP 4.0.4)
s - secunde; de exemplu "00" până la "59"
S - sufixul ordinal englezesc pentru ziua din lună, 2 caractere; de exemplu "th", "nd"
t - numărul de zile dintr-o lună dată; de exemplu "28" până la "31"
T - setările de reprezentare a timpului pe un calculator; de exemplu "MDT"
U - secunde de la începutul epocii UNIX
w - ziua din săptămână, numerică, de exemplu "0" (duminică) până la "6" (sâmbătă)
W - numărul săptămânii din an conform ISO-8601; săptămâna începe lunea (adăugată în PHP 4.1.0)
Y - anul, 4 cifre; de exemplu "1999"
y - anul, 2 cifre; de exemplu "99"
z - ziua din an; de exemplu "0" până la "365"
Z - diferența de timp față de UTC, în secunde (de exemplu "-43200" până la "43200"). Diferențele pentru zonele aflate la vest de UTC sunt întotdeauna negative și celelalte sunt întotdeauna pozitive.
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.
Este posibil să utilizați funcțiile date() și mktime() împreună pentru a găsi date în viitor sau în trecut.
Exemplu 3. Exemplu date() și mktime()
|
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.
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().