Funzione date

La funzione date visualizza la data in un formato specificato. Il primo parametro della funzione accetta il formato, e il secondo parametro opzionale - l'istante temporale in formato timestamp. Se il secondo parametro non è specificato - verrà preso l'istante corrente, se specificato - quello indicato.

Il formato è specificato da comandi di controllo (lettere inglesi), inoltre è possibile inserire qualsiasi separatore tra di essi (trattini, due punti e così via).

La funzione accetta i seguenti comandi (le lettere maiuscole sono diverse dalle minuscole, fate attenzione):

U – numero di secondi trascorsi dal 1 gennaio 1970 (cioè timestamp).
z – numero del giorno dall'inizio dell'anno.
Y – anno, 4 cifre.
y - anno, due cifre.
m – numero del mese (con zero iniziale).
n – numero del mese senza zero iniziale.
d – numero del giorno nel mese, sempre due cifre (cioè la prima può essere zero).
j – numero del giorno nel mese senza zero iniziale.
w – giorno della settimana (0 - domenica, 1 - lunedì, ecc.).
h – ore in formato 12-ore.
H – ore in formato 24-ore.
i – minuti.
s – secondi.
L – 1, se anno bisestile, 0, se non bisestile.
W – numero progressivo della settimana dell'anno.
t – numero di giorni nel mese specificato.

Sintassi

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

Esempi di utilizzo di date

<?php
	// Tutti gli esempi sono mostrati per la data 01.06.2013 alle 12.23.59, lunedì
	
	echo date('Y'); // visualizzerà '2013'
	echo date('y'); // visualizzerà '13'
	echo date('m'); // visualizzerà '06' - numero del mese
	echo date('d'); // visualizzerà '01' - numero del giorno nel mese
	echo date('j'); // visualizzerà '1'  - numero del giorno nel mese (senza zero iniziale)
	echo date('w'); // visualizzerà '1'  - lunedì
	echo date('H'); // visualizzerà '12' - ore
	echo date('i'); // visualizzerà '23' - minuti
	echo date('s'); // visualizzerà '59' - secondi
	
	echo date('d-m-Y'); // visualizzerà '01-06-2013'
	echo date('d.m.Y'); // visualizzerà '01.06.2013'
	echo date('H:i:s d.m.Y'); // visualizzerà '12:23:59 01.06.2013'
?>

Secondo parametro della funzione date

La funzione date ha un secondo parametro opzionale, che accetta un istante temporale in formato timestamp. Se si passa questo parametro, la funzione date formatterà non l'istante corrente, ma quello passato come secondo parametro. Questo timestamp può essere ottenuto, ad esempio, tramite mktime (ma non necessariamente):

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

Questo può essere utilizzato per scoprire il giorno della settimana per una data specifica - basta passarla come secondo parametro utilizzando la funzione mktime, e come primo parametro impostare il carattere di controllo 'w':

<?php
	// Scopriamo che giorno della settimana era il 29-12-2013:
	echo date('w', mktime(0, 0, 0, 12, 29, 13)); // visualizzerà '0' - domenica
?>

Vedi anche

la funzione mktime,
che restituisce un istante temporale in formato timestamp