Format de date PHP : tous les caractères de date()

Un format de date PHP est une chaîne où des lettres représentent des parties de la date : date('Y-m-d H:i:s') affiche quelque chose comme 2026-03-14 09:05:07. Y est l'année sur 4 chiffres, m le mois, d le jour, H l'heure (sur 24 heures), i les minutes et s les secondes ; tout caractère qui n'est pas une lettre de format, comme -, / ou :, est affiché tel quel. Les mêmes chaînes de format fonctionnent dans date() et dans DateTimeImmutable::format().

Modifiez $format et cliquez sur Run. La date est fixée au samedi 14 mars 2026 à 09:05:07, pour que vous voyiez exactement ce que fait chaque lettre :

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');

$format = 'D, d M Y H:i';   // edit me

echo $date->format($format), "\n";
echo $date->format('Y-m-d'), "\n";
echo $date->format('d/m/Y'), "\n";
echo $date->format('l, F jS, Y'), "\n";
echo $date->format('g:i A'), "\n";

Sortie :

Sat, 14 Mar 2026 09:05
2026-03-14
14/03/2026
Saturday, March 14th, 2026
9:05 AM

date($format) formate l'instant présent et date($format, $timestamp) un timestamp ; $date->format($format) formate un objet date. Tout le reste sur les dates, de strtotime() aux fuseaux horaires, est sur la page PHP date().

Les caractères de format de date

Chaque exemple ci-dessous est le résultat pour 2026-03-14 09:05:07.123456 UTC.

Jour

Semaine et mois

Année

Heure

Fuseau horaire

Date et heure complètes

Le même tableau, en direct : ce bloc affiche chaque caractère pour une date de votre choix. Mettez votre date d'anniversaire, une date dans l'après-midi, ou une date à la fin d'une année bissextile :

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07.123456');   // try '2028-12-31 18:45'

foreach (str_split('djDlNwSzWFMmntYyLoXxHGhgisaAvuBeTPpOZIcrU') as $char) {
    echo $char, '  ', $date->format($char), "\n";
}

Afficher des lettres et des mots dans un format

Toute lettre d'une chaîne de format est lue comme un caractère de format, donc 'Today is l' n'affiche pas « Today is » : T, o, d, a, y, i et s sont tous des caractères de format. Placez une barre oblique inverse devant chaque lettre que vous voulez afficher telle quelle. Dans une chaîne entre guillemets doubles, \t est déjà une tabulation, utilisez donc des guillemets simples pour les formats contenant des barres obliques inverses :

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');

echo $date->format('Today is l'), "\n";            // letters read as format characters
echo $date->format('\T\o\d\a\y \i\s l'), "\n";     // escaped
echo $date->format('l \t\h\e jS \o\f F'), "\n";
echo $date->format('Y-m-d\TH:i:s'), "\n";          // a literal T between date and time

echo $date->format("l \the jS"), "\n";             // double quotes: \t is a tab, h and e are format letters

Sortie :

UTC202614am26 0507 Saturday
Today is Saturday
Saturday the 14th of March
2026-03-14T09:05:07
Saturday 	09UTC 14th

Les formats de date courants

La plupart du code n'a besoin que de quelques formats. Ce bloc les affiche sous forme de tableau HTML, visible dans l'onglet Page :

<?php
$date = new DateTimeImmutable('2026-03-14 15:45:00');

$formats = [
    'Y-m-d'       => 'ISO date, sorts correctly as text',
    'Y-m-d H:i:s' => 'MySQL DATETIME',
    'm/d/Y'       => 'United States',
    'd/m/Y'       => 'UK, Europe, most of the world',
    'd.m.Y'       => 'Germany, Russia',
    'F j, Y'      => 'Long US style',
    'j F Y'       => 'Long UK style',
    'D, M j'      => 'Short, for lists',
    'g:i a'       => '12-hour clock',
    'H:i'         => '24-hour clock',
];
?>
<table border="1" cellpadding="6" style="border-collapse: collapse">
    <tr><th>Format</th><th>Result</th><th>Used for</th></tr>
<?php foreach ($formats as $format => $use): ?>
    <tr>
        <td><code><?= $format ?></code></td>
        <td><?= $date->format($format) ?></td>
        <td><?= $use ?></td>
    </tr>
<?php endforeach; ?>
</table>

Stockez et comparez les dates au format Y-m-d ou Y-m-d H:i:s : des chaînes dans cet ordre se trient comme les dates, ce que ne font pas les chaînes d/m/Y.

ISO 8601, DATE_ATOM et autres formats standard

PHP a des constantes pour les formats qu'attendent les API, les flux et les cookies. DATE_ATOM (aussi DateTimeInterface::ATOM) correspond à l'ISO 8601 et au RFC 3339, le format qu'utilisent les API JSON :

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');

echo $date->format(DATE_ATOM), "\n";               // ISO 8601
echo $date->format('c'), "\n";                     // the same, as a character
echo $date->format(DATE_RFC3339_EXTENDED), "\n";   // with milliseconds
echo $date->format(DATE_RFC2822), "\n";            // email headers
echo $date->format(DATE_RSS), "\n";                // RSS feeds
echo $date->format(DATE_COOKIE), "\n";             // cookies

echo DATE_ATOM, "\n";                              // the format string behind it

Sortie :

2026-03-14T09:05:07+00:00
2026-03-14T09:05:07+00:00
2026-03-14T09:05:07.000+00:00
Sat, 14 Mar 2026 09:05:07 +0000
Sat, 14 Mar 2026 09:05:07 +0000
Saturday, 14-Mar-2026 09:05:07 UTC
Y-m-d\TH:i:sP

Il existe aussi une constante DATE_ISO8601, mais son décalage n'a pas de deux-points (+0000), ce que l'ISO 8601 n'autorise pas sous cette forme ; utilisez DATE_ATOM.

Format de date japonais (Y年m月d日)

Les caractères qui ne sont pas des lettres de format sont affichés tels quels, y compris les kanji, donc 'Y年n月j日' fonctionne tel quel. n et j suppriment le zéro initial (3月14日), m et d le gardent (03月14日). Le nom du jour est la seule partie que date() ne peut pas traduire, car elle ne connaît que les noms anglais ; associez plutôt le numéro w à votre propre liste :

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');
$weekdays = ['日', '月', '火', '水', '木', '金', '土'];   // w: 0 = Sunday

echo $date->format('Y年n月j日'), "\n";
echo $date->format('Y年m月d日 H時i分'), "\n";
echo $date->format('Y年n月j日'), '(', $weekdays[$date->format('w')], ")\n";
echo $date->format('Y/m/d'), "\n";

Sortie :

2026年3月14日
2026年03月14日 09時05分
2026年3月14日(土)
2026/03/14

Pour une localisation complète, y compris les noms de mois dans d'autres langues et l'ère japonaise (令和), le IntlDateFormatter de l'extension intl formate avec des motifs de locale. Il utilise les lettres de motif ICU (yyyy, MM, EEEE), pas les caractères PHP de cette page :

<?php
$formatter = new IntlDateFormatter('ja_JP', IntlDateFormatter::FULL, IntlDateFormatter::NONE, 'Asia/Tokyo');
echo $formatter->format(new DateTimeImmutable('2026-03-14')); // 2026年3月14日土曜日

$era = new IntlDateFormatter('ja_JP@calendar=japanese', IntlDateFormatter::LONG, IntlDateFormatter::NONE, 'Asia/Tokyo', IntlDateFormatter::TRADITIONAL);
echo $era->format(new DateTimeImmutable('2026-03-14'));       // 令和8年3月14日

Convertir une date d'un format à un autre

Pour transformer 14/03/2026 en 2026-03-14, analysez la chaîne avec le format dans lequel elle est écrite, avec DateTimeImmutable::createFromFormat(), puis formatez-la à nouveau. Elle utilise les mêmes caractères que le tableau. Commencez le format par !, sinon les champs que vous n'avez pas donnés (ici l'heure) sont remplis avec l'instant présent :

<?php
$input = '14/03/2026';

$date = DateTimeImmutable::createFromFormat('!d/m/Y', $input);
if ($date === false) {
    exit("Not a d/m/Y date\n");
}
echo $date->format('Y-m-d H:i:s'), "\n";
echo $date->format('F j, Y'), "\n";

// The string must match the format, or you get false
var_dump(DateTimeImmutable::createFromFormat('!d/m/Y', '2026-03-14'));

// A date that does not exist overflows, and getLastErrors() says so
$feb31 = DateTimeImmutable::createFromFormat('!d/m/Y', '31/02/2026');
echo $feb31->format('Y-m-d'), "\n";
print_r(DateTimeImmutable::getLastErrors()['warnings']);

Sortie :

2026-03-14 00:00:00
March 14, 2026
bool(false)
2026-03-03
Array
(
    [10] => The parsed date was invalid
)

Pour des dates tapées par des utilisateurs, traitez tout warning de getLastErrors() comme une date invalide, de la même façon que false.

Erreurs fréquentes avec les formats de date

Trois bugs reviennent sans cesse : m à la place de i, Y au lieu de y, et laisser strtotime() deviner l'ordre du jour et du mois. strtotime() lit les barres obliques dans l'ordre américain mois/jour et les tirets ou points dans l'ordre jour-mois, donc les mêmes chiffres donnent deux dates différentes :

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');

echo $date->format('H:m:s'), "\n";   // wrong: m is the month
echo $date->format('H:i:s'), "\n";   // right: i is the minutes
echo $date->format('d/m/y'), "\n";   // y: 2-digit year

echo date('Y-m-d', strtotime('03/04/2026')), "\n";   // m/d/Y: March 4
echo date('Y-m-d', strtotime('03-04-2026')), "\n";   // d-m-Y: April 3
var_dump(strtotime('14/03/2026'));                   // no month 14: false

Sortie :

09:03:07
09:05:07
14/03/26
2026-03-04
2026-04-03
bool(false)

Quand vous connaissez le format de l'entrée, indiquez-le avec createFromFormat() au lieu de laisser strtotime() deviner.