date

(PHP 3, PHP 4 , PHP 5)

date -- Formatează data/timpul local

Descriere

string date ( string format [, int timestamp])

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:

Caracterele nerecunoscute din format vor fi afișate ca atare. Formatul "Z" va returna întotdeauna "0" când se folosește gmdate().

Exemplu 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.

Exemplu 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.

Exemplu 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.

Exemplu 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().