Fonction date

La fonction date affiche la date dans un format donné. Le premier paramètre de la fonction accepte le format, et le deuxième paramètre optionnel - un instant dans le format timestamp. Si le deuxième paramètre n'est pas spécifié - l'instant actuel sera pris, s'il est spécifié - celui indiqué.

Le format est spécifié par des commandes de contrôle (lettres anglaises), et il est possible d'insérer n'importe quel séparateur entre elles (tirets, deux-points et ainsi de suite).

La fonction accepte les commandes suivantes (les lettres majuscules diffèrent des minuscules, veuillez noter) :

U – nombre de secondes écoulées depuis le 1 janvier 1970 (c'est-à-dire timestamp).
z – numéro du jour depuis le début de l'année.
Y – année, 4 chiffres.
y - année, deux chiffres.
m – numéro du mois (avec un zéro devant).
n – numéro du mois sans zéro devant.
d – numéro du jour dans le mois, toujours deux chiffres (la première peut être un zéro).
j – numéro du jour dans le mois sans zéro non significatif.
w – jour de la semaine (0 - dimanche, 1 - lundi, etc.).
h – heures au format 12 heures.
H – heures au format 24 heures.
i – minutes.
s – secondes.
L – 1, si année bissextile, 0, si année non bissextile.
W – numéro de semaine de l'année.
t – nombre de jours dans le mois indiqué.

Syntaxe

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

Exemples d'utilisation de date

<?php
	// Tous les exemples sont montrés pour la date 01.06.2013 à 12.23.59, lundi
	
	echo date('Y'); // affichera '2013'
	echo date('y'); // affichera '13'
	echo date('m'); // affichera '06' - numéro du mois
	echo date('d'); // affichera '01' - numéro du jour dans le mois
	echo date('j'); // affichera '1'  - numéro du jour dans le mois (sans zéro non significatif)
	echo date('w'); // affichera '1'  - lundi
	echo date('H'); // affichera '12' - heures
	echo date('i'); // affichera '23' - minutes
	echo date('s'); // affichera '59' - secondes
	
	echo date('d-m-Y'); // affichera '01-06-2013'
	echo date('d.m.Y'); // affichera '01.06.2013'
	echo date('H:i:s d.m.Y'); // affichera '12:23:59 01.06.2013'
?>

Deuxième paramètre de la fonction date

La fonction date a un deuxième paramètre optionnel, qui accepte un instant au format timestamp. Si ce paramètre est transmis, la fonction date formatera non pas l'instant actuel, mais celui qui est passé en deuxième paramètre. Ce timestamp peut être obtenu, par exemple, via mktime (mais pas nécessairement) :

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

Cela peut être utilisé pour connaître le jour de la semaine d'une date spécifique - il suffit de la passer en deuxième paramètre à l'aide de la fonction mktime, et de mettre le caractère de contrôle 'w' en premier paramètre :

<?php
	// Découvrons quel jour de la semaine était le 29-12-2013 :
	echo date('w', mktime(0, 0, 0, 12, 29, 13)); // affichera '0' - dimanche
?>

Voir aussi

la fonction mktime,
qui retourne un instant au format timestamp