Description

Retourne une date sous forme d'une chaîne, au format donné par le paramètre format, fournie par le paramètre timestamp ou la date et l'heure courantes si aucun timestamp n'est fourni. En d'autres termes, le paramètre timestamp est optionnel et vaut par défaut la valeur de la fonction time().

Liste de paramètres

Valeurs de retour

Retourne une date formattée. Si une valeur non-numérique est utilisée dans le paramètre timestamp, FALSE sera retourné et une erreur de niveau E_WARNING est émise.

Erreurs / Exceptions

Chaque appel à une fonction date/heure génèrera un message de type E_NOTICE si le fuseau horaire n'est pas valide., et/ou un message de type E_STRICT si vous utilisez la configuration du système ou la variable d'environnement TZ. Voir aussi date_default_timezone_set()

Historique

Exemples

Exemple 1. Exemple avec date() <?php // Définit le fuseau horaire par défaut à utiliser. Disponible depuis PHP 5.1 date_default_timezone_set('UTC'); // Affichage de quelque chose comme : Monday echo date("l"); // Affichage de quelque chose comme : Monday 15th of August 2005 03:12:46 PM echo date('l dS \of F Y h:i:s A'); // Affiche : July 1, 2000 is on a Saturday echo "July 1, 2000 is on a " . date("l", mktime(0, 0, 0, 7, 1, 2000)); /* utilise les constantes dans le paramètre format */ // Affichage de quelque chose comme : Mon, 15 Aug 2005 15:12:46 UTC echo date(DATE_RFC822); // Affichage de quelque chose comme : 2000-07-01T00:00:00+00:00 echo date(DATE_ATOM, mktime(0, 0, 0, 7, 1, 2000)); ?>

Vous pouvez faire afficher un caractère spécial dans la chaîne de format en le protégeant par un anti-slash. Si le caractère est lui-même une séquence incluant un anti-slash, vous devrez protéger aussi l'anti-slash.

Exemple 2. Protection des caractères dans la fonction date() <?php // Affichage de quelque chose comme : Wednesday the 15th echo date("l \\t\h\e jS"); ?>

Il est possible d'utiliser date() et mktime() ensemble pour générer des dates dans le futur ou dans le passé.

Exemple 3. Exemple avec date() et mktime() <?php $tomorrow  = mktime(0, 0, 0, date("m")  , date("d")+1, date("Y")); $lastmonth = mktime(0, 0, 0, date("m")-1, date("d"),   date("Y")); $nextyear  = mktime(0, 0, 0, date("m"),   date("d"),   date("Y")+1); ?>

Voici maintenant quelques exemples de formatage avec date(). Notez que vous devriez échapper tous les autres caractères, car s'ils ont une signification spéciale, ils risquent de produire des effets secondaires indésirables. Notez aussi que les versions futures de PHP peuvent attribuer une signification à des lettres qui sont actuellement inertes. Lorsque vous échappez les caractères, pensez à utiliser des guillemets simples, pour que les séquences \n ne deviennent pas des nouvelles lignes.

Exemple 4. Exemple avec date() <?php // Aujourd'hui, le 12 Mars 2001, 10:16:18 pm $today = date("F j, Y, g:i a");                 // March 10, 2001, 5:16 pm $today = date("m.d.y");                         // 03.10.01 $today = date("j, n, Y");                       // 10, 3, 2001 $today = date("Ymd");                           // 20010310 $today = date('h-i-s, j-m-y, it is w Day z ');  // 05-16-17, 10-03-01, 1631 1618 6 Fripm01 $today = date('\i\t \i\s \t\h\e jS \d\a\y.');   // C'est le 12th jour. $today = date("D M j G:i:s T Y");               // Sat Mar 10 15:16:08 MST 2001 $today = date('H:m:s \m \i\s\ \m\o\n\t\h');     // 17:03:17 m est le mois $today = date("H:i:s");                         // 17:16:17 ?>

Pour formater des dates dans d'autres langues, utilisez les fonctions setlocale() et strftime() au lieu de la fonction date().

Notes

Voir aussi