PHP Datumsformat: jedes Formatzeichen von date()

Ein PHP-Datumsformat ist ein String, in dem Buchstaben für Teile des Datums stehen: date('Y-m-d H:i:s') gibt etwas wie 2026-03-14 09:05:07 aus. Y ist das vierstellige Jahr, m der Monat, d der Tag, H die Stunde (24-Stunden-Format), i die Minuten und s die Sekunden; jedes Zeichen, das kein Formatbuchstabe ist, etwa -, / oder :, wird unverändert ausgegeben. Dieselben Format-Strings funktionieren in date() und in DateTimeImmutable::format().

Ändere $format und klicke auf Run. Das Datum ist auf Samstag, den 14. März 2026 um 09:05:07 festgelegt, sodass du genau siehst, was jeder Buchstabe macht:

<?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";

Ausgabe:

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

date($format) formatiert den aktuellen Moment und date($format, $timestamp) einen Timestamp; $date->format($format) formatiert ein Datumsobjekt. Alles andere über Daten, von strtotime() bis zu Zeitzonen, steht auf der Seite zu PHP date().

Formatzeichen für Datumsangaben

Jedes Beispiel unten ist das Ergebnis für 2026-03-14 09:05:07.123456 UTC.

Tag

Woche und Monat

Jahr

Uhrzeit

Zeitzone

Vollständiges Datum und Uhrzeit

Dieselbe Tabelle, live: Dieser Block gibt jedes Zeichen für ein Datum deiner Wahl aus. Setz deinen Geburtstag ein, ein Datum am Nachmittag oder eines am Ende eines Schaltjahres:

<?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";
}

Buchstaben und Wörter in einem Format ausgeben

Jeder Buchstabe in einem Format-String wird als Formatzeichen gelesen, also gibt 'Today is l' nicht „Today is“ aus: T, o, d, a, y, i und s sind alles Formatzeichen. Setze vor jeden Buchstaben, der unverändert ausgegeben werden soll, einen Backslash. In einem String in doppelten Anführungszeichen ist \t schon ein Tabulator, also verwendest du für Formate mit Backslashes einfache Anführungszeichen:

<?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

Ausgabe:

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

Gängige Datumsformate

Der meiste Code braucht nur eine Handvoll Formate. Dieser Block gibt sie als HTML-Tabelle aus, also erscheint sie im Tab 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>

Speichere und vergleiche Daten als Y-m-d oder Y-m-d H:i:s: Strings in dieser Reihenfolge sortieren sich genauso wie die Daten, was bei d/m/Y-Strings nicht der Fall ist.

ISO 8601, DATE_ATOM und andere Standardformate

PHP hat Konstanten für die Formate, die APIs, Feeds und Cookies erwarten. DATE_ATOM (auch DateTimeInterface::ATOM) ist ISO 8601 und RFC 3339, das Format, das JSON-APIs verwenden:

<?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

Ausgabe:

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

Es gibt auch eine Konstante DATE_ISO8601, aber ihr Offset hat keinen Doppelpunkt (+0000), was ISO 8601 in dieser Form nicht erlaubt; verwende DATE_ATOM.

Japanisches Datumsformat (Y年m月d日)

Zeichen, die keine Formatbuchstaben sind, werden unverändert ausgegeben, und das gilt auch für Kanji, also funktioniert 'Y年n月j日' so, wie es dasteht. n und j lassen die führende Null weg (3月14日), m und d behalten sie (03月14日). Der Tagesname ist der eine Teil, den date() nicht übersetzen kann, weil es nur englische Namen kennt; ordne stattdessen die Zahl w deiner eigenen Liste zu:

<?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";

Ausgabe:

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

Für vollständige Lokalisierung, einschließlich Monatsnamen in anderen Sprachen und der japanischen Ära (令和), formatiert IntlDateFormatter aus der intl-Erweiterung mit Locale-Mustern. Es verwendet ICU-Musterbuchstaben (yyyy, MM, EEEE), nicht die PHP-Zeichen dieser Seite:

<?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日

Ein Datum von einem Format in ein anderes umwandeln

Um 14/03/2026 in 2026-03-14 zu verwandeln, parst du den String mit DateTimeImmutable::createFromFormat() im Format, in dem er geschrieben ist, und formatierst ihn dann neu. Es verwendet dieselben Zeichen wie die Tabelle. Beginne das Format mit !, sonst werden Felder, die du nicht angegeben hast (hier die Uhrzeit), mit dem aktuellen Moment gefüllt:

<?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']);

Ausgabe:

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

Bei Daten, die Nutzer eintippen, behandelst du jede Warnung aus getLastErrors() als ungültiges Datum, genauso wie false.

Typische Fehler mit Datumsformaten

Drei Bugs tauchen immer wieder auf: m, wo i gemeint war, Y gegenüber y und strtotime() die Reihenfolge von Tag und Monat raten zu lassen. strtotime() liest Schrägstriche in amerikanischer Reihenfolge Monat/Tag und Bindestriche oder Punkte in der Reihenfolge Tag, Monat, also ergeben dieselben Ziffern zwei verschiedene Daten:

<?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

Ausgabe:

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

Wenn du das Format der Eingabe kennst, nenn es mit createFromFormat(), statt strtotime() raten zu lassen.