PHP date(): Datum holen, formatieren und berechnen

date('Y-m-d') liefert das heutige Datum als String, etwa 2026-03-14. Das erste Argument ist ein Format-String, in dem jeder Buchstabe für einen Teil des Datums steht (Y das Jahr, m der Monat, d der Tag, H:i:s die Uhrzeit), und ein optionales zweites Argument ist ein Unix-Timestamp, der statt des aktuellen Moments formatiert wird.

<?php
echo date('Y-m-d'), "\n";          // today's date
echo date('H:i:s'), "\n";          // current time, 24-hour clock
echo date('Y-m-d H:i:s'), "\n";    // both, the format databases use
echo date('l, F jS, Y'), "\n";     // long form, e.g. Saturday, March 14th, 2026
echo time(), "\n";                 // seconds since 1970-01-01 00:00:00 UTC

Die Ausgabe ändert sich bei jedem Klick auf Run, weil es das aktuelle Datum und die aktuelle Uhrzeit in UTC sind. Jeder Buchstabe des Format-Strings und wie du normalen Text dazwischen setzt, steht auf der Seite zum PHP-Datumsformat.

Timestamps: time(), mktime() und strtotime()

Ein Unix-Timestamp ist die Zahl der Sekunden seit dem 1. Januar 1970 um Mitternacht UTC. time() liefert den aktuellen, mktime(hour, minute, second, month, day, year) baut einen aus Teilen, und strtotime() liest ein auf Englisch geschriebenes Datum ('2026-03-14', '+1 week', 'next monday'). Übergib einen beliebigen Timestamp als zweites Argument an date(). Das zweite Argument von strtotime() ist der Moment, ab dem eine relative Angabe zählt; ohne zählt sie ab jetzt.

<?php
$ts = mktime(9, 30, 0, 3, 14, 2026);   // 2026-03-14 09:30:00
echo $ts, "\n";
echo date('D, d M Y H:i', $ts), "\n";

// mktime() rolls over: month 13 of 2026 is January 2027
echo date('Y-m-d', mktime(0, 0, 0, 13, 1, 2026)), "\n\n";

$phrases = ['tomorrow', '+1 week', 'next monday', 'last day of this month', 'first monday of next month'];
foreach ($phrases as $phrase) {
    echo str_pad($phrase, 28), date('D Y-m-d', strtotime($phrase, $ts)), "\n";
}

var_dump(strtotime('not a date'));   // false: check before you use it

Ausgabe:

1773480600
Sat, 14 Mar 2026 09:30
2027-01-01

tomorrow                    Sun 2026-03-15
+1 week                     Sat 2026-03-21
next monday                 Mon 2026-03-16
last day of this month      Tue 2026-03-31
first monday of next month  Mon 2026-04-06
bool(false)

Der Überlauf in mktime() ist nützlich: Tag 0 eines Monats ist der letzte Tag des Vormonats, also ist mktime(0, 0, 0, 3, 0, 2026) der 28. Februar. Vergleiche das Ergebnis immer mit false, bevor du es weitergibst: date('Y-m-d', false) gibt still 1970-01-01 aus, ein Datum, das niemand gemeint hat.

Tage zu einem Datum addieren

Für alles über die Ausgabe hinaus verwendest du DateTimeImmutable. Seine Methode modify() nimmt dieselben Angaben wie strtotime() und liefert ein neues Datum, und add() nimmt ein DateInterval wie P7D (ein Zeitraum von 7 Tagen) oder PT90M (90 Minuten).

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

echo $date->modify('+7 days')->format('Y-m-d'), "\n";
echo $date->modify('-1 day')->format('Y-m-d'), "\n";
echo $date->add(new DateInterval('P1M'))->format('Y-m-d'), "\n";
echo $date->add(new DateInterval('PT90M'))->format('H:i'), "\n";
echo $date->sub(new DateInterval('P1Y'))->format('Y-m-d'), "\n";

// Adding a month to January 31 overflows into March
$jan31 = new DateTimeImmutable('2026-01-31');
echo $jan31->modify('+1 month')->format('Y-m-d'), "\n";
echo $jan31->modify('last day of next month')->format('Y-m-d'), "\n";

Ausgabe:

2026-03-21
2026-03-13
2026-04-14
11:00
2025-03-14
2026-03-03
2026-02-28

Den 31. Februar gibt es nicht, also landet +1 month vom 31. Januar aus am 3. März. Wenn du „das Ende des nächsten Monats“ meinst, sag es mit last day of next month.

DateTime vs DateTimeImmutable

DateTime ändert sich selbst, wenn du modify(), add() oder setDate() aufrufst, und liefert dasselbe Objekt zurück. Das überrascht alle, die das ursprüngliche Datum in einer Variable behalten:

<?php
$start = new DateTime('2026-03-14');
$end = $start->modify('+7 days');

echo $start->format('Y-m-d'), "\n";   // the start moved too
echo $end->format('Y-m-d'), "\n";
var_dump($start === $end);            // the same object

$start = new DateTimeImmutable('2026-03-14');
$end = $start->modify('+7 days');

echo $start->format('Y-m-d'), "\n";   // unchanged
echo $end->format('Y-m-d'), "\n";

Ausgabe:

2026-03-21
2026-03-21
bool(true)
2026-03-14
2026-03-21

Bevorzuge DateTimeImmutable in neuem Code. Beide Klassen haben dieselben Methoden und implementieren beide DateTimeInterface, also kann eine Funktion beide annehmen.

Differenz zwischen zwei Daten

diff() liefert ein DateInterval. Seine Eigenschaft days ist die Gesamtzahl der Tage zwischen den beiden Daten, während y, m und d den Abstand in Jahre, Monate und Tage aufteilen, genau das, was eine Altersberechnung braucht. Ändere die Daten und führe den Code erneut aus:

<?php
$birthday = new DateTimeImmutable('1990-07-20');
$today = new DateTimeImmutable('2026-03-14');

$age = $birthday->diff($today);
echo "Age: {$age->y}\n";
echo "Exactly: {$age->y} years, {$age->m} months, {$age->d} days\n";
echo "Days alive: {$age->days}\n";

$christmas = new DateTimeImmutable('2026-12-25');
$wait = $today->diff($christmas);
echo $wait->days, " days to go\n";
echo $wait->format('%m months and %d days'), "\n";

// Reversed order: invert is 1 and %R prints the sign
echo $christmas->diff($today)->format('%R%a days'), "\n";

Ausgabe:

Age: 35
Exactly: 35 years, 7 months, 22 days
Days alive: 13021
286 days to go
9 months and 11 days
-286 days

In format() ist %a die Gesamtzahl der Tage und %d nur der Tagesanteil, also verwendest du %a für „Tage bis“. Um zwei Daten ohne Differenz zu vergleichen, funktionieren die normalen Operatoren auf Datumsobjekten: $today < $christmas ist true.

Zeitzonen

date() und new DateTimeImmutable() verwenden die Standardzeitzone, die aus date.timezone in der php.ini kommt (UTC, wenn sie nicht gesetzt ist). Setze sie für das ganze Skript mit date_default_timezone_set(), oder gib einem einzelnen Datum seine eigene DateTimeZone und wandle mit setTimezone() um:

<?php
$meeting = new DateTimeImmutable('2026-03-14 09:30', new DateTimeZone('UTC'));

foreach (['Asia/Tokyo', 'Europe/Berlin', 'America/New_York'] as $zone) {
    $local = $meeting->setTimezone(new DateTimeZone($zone));
    echo str_pad($zone, 18), $local->format('Y-m-d H:i T P'), "\n";
}

date_default_timezone_set('Asia/Tokyo');
echo date_default_timezone_get(), "\n";
echo date('Y-m-d H:i', $meeting->getTimestamp()), "\n";

Ausgabe:

Asia/Tokyo        2026-03-14 18:30 JST +09:00
Europe/Berlin     2026-03-14 10:30 CET +01:00
America/New_York  2026-03-14 05:30 EDT -04:00
Asia/Tokyo
2026-03-14 18:30

Ein Timestamp ist überall dieselbe Zahl; die Zeitzone ändert nur, wie er geschrieben wird. Deshalb lautet der übliche Rat, Daten in UTC zu speichern und bei der Anzeige umzuwandeln.

Einen Kalender auf einer Webseite zeigen

Daten werden meist in HTML ausgegeben. Dieser Block zeichnet den aktuellen Monat als Kalender und hebt den heutigen Tag hervor. Führe ihn aus und klicke dann auf Previous oder Next: Dasselbe Skript läuft erneut, mit $_GET['m'] aus dem Link, etwa ?m=2026-04.

<?php
$month = $_GET['m'] ?? date('Y-m');
$first = DateTimeImmutable::createFromFormat('!Y-m', $month)
    ?: new DateTimeImmutable('first day of this month midnight');

$prev = $first->modify('-1 month')->format('Y-m');
$next = $first->modify('+1 month')->format('Y-m');
$today = date('Y-m-d');
$days = (int) $first->format('t');   // days in this month
?>
<style>
    th, td { width: 2.4em; padding: 4px; text-align: center; }
    .today { background: #ffd54f; border-radius: 4px; }
</style>
<h3><?= $first->format('F Y') ?></h3>
<p><a href="?m=<?= $prev ?>">Previous</a> | <a href="?m=<?= $next ?>">Next</a></p>
<table>
    <tr><th>Mon</th><th>Tue</th><th>Wed</th><th>Thu</th><th>Fri</th><th>Sat</th><th>Sun</th></tr>
    <tr>
<?php
echo str_repeat('<td></td>', (int) $first->format('N') - 1);
for ($day = 1; $day <= $days; $day++) {
    $date = $first->modify('+' . ($day - 1) . ' days');
    $class = $date->format('Y-m-d') === $today ? ' class="today"' : '';
    echo "<td$class>$day</td>";
    if ($date->format('N') === '7' && $day < $days) {
        echo "</tr>\n<tr>";
    }
}
?>
    </tr>
</table>

format('N') liefert den Wochentag als 1 (Montag) bis 7 (Sonntag), also wie viele leere Zellen vor dem 1. stehen, und format('t') liefert die Anzahl der Tage im Monat. Das ! in '!Y-m' setzt jedes Feld zurück, das das Format nicht nennt, also ist der Tag der 1. und die Uhrzeit Mitternacht.

Typische Fehler mit date()

Das zweite Argument von date() muss ein Timestamp sein, kein Datums-String. Diese Zeile:

<?php
echo date('d/m/Y', '2026-03-14');

stoppt das Skript mit einem TypeError:

PHP Fatal error:  Uncaught TypeError: date(): Argument #2 ($timestamp) must be of type ?int, string given in /home/index.php:2

Wandle den String vorher um, mit strtotime() oder einem Objekt:

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

echo date('d/m/Y', strtotime($input)), "\n";
echo (new DateTimeImmutable($input))->format('d/m/Y'), "\n";

// Check that a date really exists before using it
var_dump(checkdate(2, 29, 2026));   // 2026 is not a leap year
var_dump(checkdate(2, 29, 2028));

Ausgabe:

14/03/2026
14/03/2026
bool(false)
bool(true)

Zwei weitere Fallen: m ist der Monat und i sind die Minuten, also gibt 'H:m' den Monat aus, wo du Minuten wolltest; und new DateTimeImmutable('garbage') wirft eine Exception, statt false zu liefern, also packst du Nutzereingaben in try/catch oder parst sie mit DateTimeImmutable::createFromFormat(), das bei einer Abweichung false liefert.