PHP date(): ottenere, formattare e calcolare le date

date('Y-m-d') restituisce la data di oggi come stringa, per esempio 2026-03-14. Il primo argomento è una stringa di formato in cui ogni lettera rappresenta una parte della data (Y l'anno, m il mese, d il giorno, H:i:s l'ora), e un secondo argomento facoltativo è un timestamp Unix da formattare al posto del momento attuale.

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

L'output cambia ogni volta che premi Run, perché è la data e l'ora correnti in UTC. Ogni lettera della stringa di formato, e come inserire testo semplice tra di esse, è nella pagina sul formato delle date in PHP.

Timestamp: time(), mktime() e strtotime()

Un timestamp Unix è il numero di secondi trascorsi dal 1° gennaio 1970 a mezzanotte UTC. time() restituisce quello attuale, mktime(hour, minute, second, month, day, year) ne costruisce uno a partire dalle parti, e strtotime() legge una data scritta in inglese ('2026-03-14', '+1 week', 'next monday'). Passa qualsiasi timestamp come secondo argomento di date(). Il secondo argomento di strtotime() è il momento da cui conta una frase relativa; senza, conta da adesso.

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

Output:

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)

Lo scorrimento di mktime() è utile: il giorno 0 di un mese è l'ultimo giorno del mese precedente, quindi mktime(0, 0, 0, 3, 0, 2026) è il 28 febbraio. Confronta sempre il risultato con false prima di passarlo oltre: date('Y-m-d', false) stampa in silenzio 1970-01-01, una data che nessuno intendeva.

Aggiungere giorni a una data

Per tutto ciò che va oltre la stampa, usa DateTimeImmutable. Il suo metodo modify() accetta le stesse frasi di strtotime() e restituisce una nuova data, e add() accetta un DateInterval come P7D (un periodo di 7 giorni) o PT90M (90 minuti).

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

Output:

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

Il 31 febbraio non esiste, quindi +1 month sul 31 gennaio arriva al 3 marzo. Quando intendi "la fine del mese prossimo", dillo con last day of next month.

DateTime vs DateTimeImmutable

DateTime modifica se stesso quando chiami modify(), add() o setDate(), e restituisce lo stesso oggetto. Questo sorprende chi tiene la data originale in una variabile:

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

Output:

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

Preferisci DateTimeImmutable nel codice nuovo. Le due classi hanno gli stessi metodi ed entrambe implementano DateTimeInterface, quindi una funzione può accettare l'una o l'altra.

Differenza tra due date

diff() restituisce un DateInterval. La sua proprietà days è il numero totale di giorni tra le due date, mentre y, m e d dividono lo scarto in anni, mesi e giorni, esattamente ciò che serve per calcolare un'età. Cambia le date ed eseguilo di nuovo:

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

Output:

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(), %a è il totale dei giorni e %d è solo la parte dei giorni, quindi per "giorni mancanti" va usato %a. Per confrontare due date senza calcolare una differenza, gli operatori normali funzionano sugli oggetti data: $today < $christmas è true.

Fusi orari

date() e new DateTimeImmutable() usano il fuso orario di default, che viene da date.timezone in php.ini (UTC se non è impostato). Impostalo per l'intero script con date_default_timezone_set(), oppure dai a una singola data il suo DateTimeZone e converti con 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";

Output:

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

Un timestamp è lo stesso numero ovunque; il fuso orario cambia solo il modo in cui viene scritto. Ecco perché il consiglio abituale è salvare le date in UTC e convertirle quando le mostri.

Mostrare un calendario in una pagina web

Le date vengono stampate soprattutto nell'HTML. Questo blocco disegna il mese corrente come calendario ed evidenzia oggi. Eseguilo, poi clicca Previous o Next: lo stesso script viene eseguito di nuovo con $_GET['m'] preso dal link, come ?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') dà il giorno della settimana da 1 (lunedì) a 7 (domenica), cioè quante celle vuote vanno prima del giorno 1, e format('t') dà il numero di giorni del mese. Il ! in '!Y-m' azzera ogni campo che il formato non menziona, quindi il giorno è il 1° e l'ora è mezzanotte.

Errori comuni con date()

Il secondo argomento di date() deve essere un timestamp, non una stringa di data. Questa riga:

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

ferma lo script con un TypeError:

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

Converti prima la stringa, con strtotime() o con un oggetto:

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

Output:

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

Altri due da tenere d'occhio: m è il mese e i sono i minuti, quindi 'H:m' stampa il mese dove volevi i minuti; e new DateTimeImmutable('garbage') lancia un'eccezione invece di restituire false, quindi racchiudi l'input dell'utente in try/catch oppure analizzalo con DateTimeImmutable::createFromFormat(), che restituisce false se non corrisponde.