Format daty w PHP: wszystkie znaki formatu date()

Format daty w PHP to string, w którym litery oznaczają części daty: date('Y-m-d H:i:s') wypisuje coś w rodzaju 2026-03-14 09:05:07. Y to rok czterocyfrowy, m miesiąc, d dzień, H godzina (zegar 24-godzinny), i minuty, a s sekundy; każdy znak, który nie jest literą formatu, taki jak -, / czy :, jest wypisywany bez zmian. Te same stringi formatu działają w date() i w DateTimeImmutable::format().

Zmień $format i naciśnij Run. Data jest ustalona na sobotę 14 marca 2026, 09:05:07, więc widać dokładnie, co robi każda litera:

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

Wynik:

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

date($format) formatuje bieżącą chwilę, a date($format, $timestamp) znacznik czasu; $date->format($format) formatuje obiekt daty. Wszystko inne o datach, od strtotime() po strefy czasowe, opisuje strona date() w PHP.

Znaki formatu daty

Każdy przykład poniżej to wynik dla 2026-03-14 09:05:07.123456 UTC.

Dzień

Tydzień i miesiąc

Rok

Czas

Strefa czasowa

Pełna data i godzina

Ta sama tabela na żywo: ten blok wypisuje każdy znak dla wybranej daty. Wstaw swoje urodziny, datę po południu albo koniec roku przestępnego:

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

Litery i słowa wewnątrz formatu

Każda litera w stringu formatu jest czytana jako znak formatu, więc 'Today is l' nie wypisuje „Today is”: T, o, d, a, y, i i s to wszystko znaki formatu. Postaw ukośnik wsteczny przed każdą literą, którą chcesz wypisać bez zmian. W stringu w podwójnych cudzysłowach \t jest już znakiem tabulacji, więc formaty z ukośnikami wstecznymi pisz w pojedynczych cudzysłowach:

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

Wynik:

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

Popularne formaty dat

Większość kodu potrzebuje tylko kilku formatów. Ten blok wypisuje je jako tabelę HTML, więc pojawia się w zakładce 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>

Przechowuj i porównuj daty jako Y-m-d albo Y-m-d H:i:s: stringi w tej kolejności sortują się tak samo jak daty, czego nie robią stringi d/m/Y ani polskie d.m.Y.

ISO 8601, DATE_ATOM i inne standardowe formaty

PHP ma stałe dla formatów, których oczekują API, kanały i ciasteczka. DATE_ATOM (także DateTimeInterface::ATOM) to ISO 8601 i RFC 3339, format używany przez API w 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

Wynik:

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

Istnieje też stała DATE_ISO8601, ale jej przesunięcie nie ma dwukropka (+0000), na co ISO 8601 w tej postaci nie pozwala; używaj DATE_ATOM.

Japoński format daty (Y年m月d日)

Znaki, które nie są literami formatu, są wypisywane bez zmian, także kanji, więc 'Y年n月j日' działa tak, jak jest zapisane. n i j pomijają zero wiodące (3月14日), a m i d je zachowują (03月14日). Nazwa dnia to jedyna część, której date() nie przetłumaczy, bo zna tylko angielskie nazwy; zamiast tego przypisz liczbie w własną listę (tak samo zrobisz z polskimi nazwami dni):

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

Wynik:

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

Do pełnej lokalizacji, w tym nazw miesięcy w innych językach i japońskiej ery (令和), IntlDateFormatter z rozszerzenia intl formatuje według wzorców locale. Używa liter wzorców ICU (yyyy, MM, EEEE), a nie znaków PHP z tej strony:

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

Konwersja daty z jednego formatu na inny

Aby zamienić 14/03/2026 na 2026-03-14, sparsuj string formatem, w którym jest zapisany, przez DateTimeImmutable::createFromFormat(), a potem sformatuj go ponownie. Używa tych samych znaków co tabela. Zacznij format od !, inaczej pola, których nie podałeś (tutaj godzina), zostaną wypełnione z bieżącej chwili:

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

Wynik:

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

Przy datach wpisywanych przez użytkowników traktuj każde ostrzeżenie z getLastErrors() jako niepoprawną datę, tak samo jak false.

Częste błędy z formatami dat

Trzy błędy pojawiają się raz po raz: m tam, gdzie miało być i, Y kontra y oraz pozwalanie, by strtotime() zgadywało kolejność dnia i miesiąca. strtotime() czyta ukośniki w amerykańskiej kolejności miesiąc/dzień, a myślniki i kropki w kolejności dzień-miesiąc, więc te same cyfry dają dwie różne daty:

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

Wynik:

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

Gdy znasz format danych wejściowych, podaj go przez createFromFormat(), zamiast pozwalać strtotime() zgadywać.