date() w PHP: pobieranie, formatowanie i obliczanie dat

date('Y-m-d') zwraca dzisiejszą datę jako string, na przykład 2026-03-14. Pierwszy argument to string formatu, w którym każda litera oznacza część daty (Y rok, m miesiąc, d dzień, H:i:s godzinę), a opcjonalny drugi argument to znacznik czasu Unix do sformatowania zamiast bieżącej chwili.

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

Wynik zmienia się przy każdym naciśnięciu Run, bo to bieżąca data i godzina w UTC. Każdą literę stringa formatu i sposób wstawiania zwykłego tekstu między nimi opisuje strona o formacie daty w PHP.

Znaczniki czasu: time(), mktime() i strtotime()

Znacznik czasu Unix to liczba sekund od 1 stycznia 1970 o północy UTC. time() zwraca bieżący, mktime(hour, minute, second, month, day, year) buduje go z części, a strtotime() czyta datę zapisaną po angielsku ('2026-03-14', '+1 week', 'next monday'). Dowolny znacznik czasu przekaż jako drugi argument date(). Drugi argument strtotime() to chwila, od której liczy się względne wyrażenie; bez niego liczy od teraz.

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

Wynik:

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)

Przewijanie w mktime() jest przydatne: dzień 0 miesiąca to ostatni dzień miesiąca poprzedniego, więc mktime(0, 0, 0, 3, 0, 2026) to 28 lutego. Zawsze porównuj wynik z false, zanim przekażesz go dalej: date('Y-m-d', false) po cichu wypisuje 1970-01-01, datę, o którą nikomu nie chodziło.

Dodawanie dni do daty

Do wszystkiego poza wypisywaniem używaj DateTimeImmutable. Jego metoda modify() przyjmuje te same wyrażenia co strtotime() i zwraca nową datę, a add() przyjmuje DateInterval, taki jak P7D (okres 7 dni) albo PT90M (90 minut).

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

Wynik:

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

31 lutego nie istnieje, więc +1 month od 31 stycznia ląduje na 3 marca. Gdy chodzi ci o „koniec następnego miesiąca”, powiedz to wprost przez last day of next month.

DateTime vs DateTimeImmutable

DateTime zmienia sam siebie, gdy wywołujesz modify(), add() lub setDate(), i zwraca ten sam obiekt. To zaskakuje osoby, które trzymają oryginalną datę w zmiennej:

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

Wynik:

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

W nowym kodzie wybieraj DateTimeImmutable. Obie klasy mają te same metody i obie implementują DateTimeInterface, więc funkcja może przyjąć dowolną z nich.

Różnica między dwiema datami

diff() zwraca DateInterval. Jego właściwość days to łączna liczba dni między dwiema datami, a y, m i d dzielą różnicę na lata, miesiące i dni, czyli dokładnie to, czego potrzebuje obliczanie wieku. Zmień daty i uruchom ponownie:

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

Wynik:

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

W format() %a to łączna liczba dni, a %d tylko część dni, więc do „dni do” używaj %a. Aby porównać dwie daty bez obliczania różnicy, na obiektach dat działają zwykłe operatory: $today < $christmas daje true.

Strefy czasowe

date() i new DateTimeImmutable() używają domyślnej strefy czasowej, która pochodzi z date.timezone w php.ini (UTC, gdy nie jest ustawiona). Ustaw ją dla całego skryptu przez date_default_timezone_set() albo daj pojedynczej dacie własny DateTimeZone i konwertuj przez setTimezone():

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

Wynik:

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

Znacznik czasu to wszędzie ta sama liczba; strefa czasowa zmienia tylko sposób jego zapisu. Dlatego zwykła rada brzmi: przechowuj daty w UTC i konwertuj je przy wyświetlaniu.

Kalendarz na stronie WWW

Daty najczęściej wypisuje się do HTML. Ten blok rysuje bieżący miesiąc jako kalendarz i wyróżnia dzisiejszy dzień. Uruchom, a potem kliknij Previous albo Next: ten sam skrypt uruchomi się ponownie z $_GET['m'] ustawionym z linku, na przykład ?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') daje dzień tygodnia jako 1 (poniedziałek) do 7 (niedziela), czyli liczbę pustych komórek przed pierwszym dniem, a format('t') daje liczbę dni w miesiącu. ! w '!Y-m' zeruje każde pole, którego format nie wymienia, więc dzień to 1., a godzina to północ.

Częste błędy z date()

Drugi argument date() musi być znacznikiem czasu, a nie stringiem z datą. Ta linia:

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

zatrzymuje skrypt z TypeError:

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

Najpierw zamień string przez strtotime() albo obiekt:

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

Wynik:

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

Na dwie kolejne rzeczy też uważaj: m to miesiąc, a i to minuty, więc 'H:m' wypisuje miesiąc tam, gdzie chciałeś minut; a new DateTimeImmutable('garbage') rzuca wyjątek zamiast zwrócić false, więc dane od użytkownika otaczaj try/catch albo parsuj przez DateTimeImmutable::createFromFormat(), które przy niedopasowaniu zwraca false.