PHP date(): получить, отформатировать и вычислить дату

date('Y-m-d') возвращает сегодняшнюю дату строкой, например 2026-03-14. Первый аргумент это строка формата, где каждая буква обозначает часть даты (Y год, m месяц, d день, H:i:s время), а необязательный второй аргумент это метка времени Unix, которую нужно отформатировать вместо текущего момента.

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

Вывод меняется при каждом нажатии Run, потому что это текущие дата и время в UTC. Все буквы строки формата и то, как вставлять между ними обычный текст, описаны на странице о формате даты в PHP.

Метки времени: time(), mktime() и strtotime()

Метка времени Unix это число секунд с 1 января 1970 года, полночь UTC. time() возвращает текущую, mktime(hour, minute, second, month, day, year) собирает её из частей, а strtotime() читает дату, записанную по-английски ('2026-03-14', '+1 week', 'next monday'). Любую метку времени можно передать вторым аргументом date(). Второй аргумент strtotime() это момент, от которого отсчитывается относительная фраза; без него отсчёт идёт от текущего момента.

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

Вывод:

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)

Перенос в mktime() полезен: день 0 месяца это последний день предыдущего месяца, поэтому mktime(0, 0, 0, 3, 0, 2026) это 28 февраля. Всегда сравнивайте результат с false, прежде чем передавать его дальше: date('Y-m-d', false) молча выводит 1970-01-01, дату, которую никто не имел в виду.

Прибавление дней к дате

Для всего, что сложнее вывода, используйте DateTimeImmutable. Его метод modify() принимает те же фразы, что и strtotime(), и возвращает новую дату, а add() принимает DateInterval, например P7D (период в 7 дней) или PT90M (90 минут).

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

Вывод:

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

31 февраля не существует, поэтому +1 month от 31 января попадает на 3 марта. Когда вы имеете в виду "конец следующего месяца", так и пишите: last day of next month.

DateTime и DateTimeImmutable

DateTime меняет сам себя, когда вы вызываете modify(), add() или setDate(), и возвращает тот же объект. Это удивляет тех, кто хранит исходную дату в переменной:

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

Вывод:

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

В новом коде предпочитайте DateTimeImmutable. У обоих классов одинаковые методы, и оба реализуют DateTimeInterface, поэтому функция может принимать любой из них.

Разница между двумя датами

diff() возвращает DateInterval. Его свойство days это общее число дней между двумя датами, а y, m и d раскладывают разрыв на годы, месяцы и дни, ровно то, что нужно для вычисления возраста. Измените даты и запустите снова:

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

Вывод:

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

В format() %a это общее число дней, а %d только дневная часть, поэтому для "сколько дней осталось" нужен %a. Чтобы сравнить две даты без вычисления разницы, с объектами дат работают обычные операторы: $today < $christmas даёт true.

Часовые пояса

date() и new DateTimeImmutable() используют часовой пояс по умолчанию, который берётся из date.timezone в php.ini (UTC, если он не задан). Задайте его для всего скрипта через date_default_timezone_set() или дайте отдельной дате собственный DateTimeZone и преобразуйте через 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";

Вывод:

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

Метка времени везде одно и то же число; часовой пояс меняет только то, как она записана. Поэтому обычно советуют хранить даты в UTC и преобразовывать их при выводе.

Календарь на веб-странице

Чаще всего даты выводят в HTML. Этот блок рисует календарь текущего месяца и выделяет сегодняшний день. Запустите его, затем нажмите Previous или Next: тот же скрипт выполнится снова с $_GET['m'] из ссылки, например ?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') даёт день недели от 1 (понедельник) до 7 (воскресенье), и столько пустых ячеек ставится перед 1-м числом, а format('t') даёт число дней в месяце. ! в '!Y-m' сбрасывает все поля, которые формат не упоминает, поэтому день будет 1-м, а время полночью.

Частые ошибки с date()

Второй аргумент date() должен быть меткой времени, а не строкой с датой. Эта строка:

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

останавливает скрипт с TypeError:

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

Сначала преобразуйте строку через strtotime() или объект:

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

Вывод:

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

Ещё две ловушки: m это месяц, а i минуты, поэтому 'H:m' выводит месяц там, где вы хотели минуты; а new DateTimeImmutable('garbage') выбрасывает исключение, а не возвращает false, поэтому оборачивайте пользовательский ввод в try/catch или разбирайте его через DateTimeImmutable::createFromFormat(), которая при несовпадении возвращает false.