PHPのdate()：日付の取得、フォーマット、計算

date('Y-m-d')は、2026-03-14のように今日の日付を文字列で返します。1つ目の引数はフォーマット文字列で、各文字が日付の一部を表し（Yは年、mは月、dは日、H:i:sは時刻）、任意の2つ目の引数には、現在の瞬間の代わりにフォーマットする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

出力はUTCでの現在の日時なので、Runを押すたびに変わります。フォーマット文字列のすべての文字と、その間にただのテキストを入れる方法は、PHPの日付フォーマットのページにあります。

タイムスタンプ：time()、mktime()、strtotime()

Unixタイムスタンプは、1970年1月1日午前0時（UTC）からの秒数です。time()は現在のタイムスタンプを返し、mktime(hour, minute, second, month, day, year)は部品からタイムスタンプを作り、strtotime()は英語で書かれた日付（'2026-03-14'、'+1 week'、'next monday'）を読み取ります。どのタイムスタンプもdate()の2つ目の引数として渡せます。strtotime()の2つ目の引数は相対的な表現の起点となる瞬間で、省くと現在から数えます。

<?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)は2月28日です。結果は渡す前に必ずfalseと比較しましょう。date('Y-m-d', false)は、誰も意図していない1970-01-01を黙って出力してしまいます。

日付に日数を足す

出力以上のことをするならDateTimeImmutableを使います。そのmodify()メソッドはstrtotime()と同じ表現を受け取って新しい日付を返し、add()はP7D（7日間）やPT90M（90分）のようなDateIntervalを受け取ります。

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

2月31日は存在しないので、1月31日に+1 monthすると3月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を実装しているので、関数はどちらも受け付けられます。

2つの日付の差

diff()はDateIntervalを返します。そのdaysプロパティは2つの日付の間の合計の日数で、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を使います。差を求めずに2つの日付を比べるだけなら、普通の演算子が日付のオブジェクトに使えます：$today < $christmasはtrueです。

タイムゾーン

date()とnew DateTimeImmutable()はデフォルトのタイムゾーンを使い、それはphp.iniのdate.timezoneから来ます（設定されていなければUTC）。スクリプト全体に設定するにはdate_default_timezone_set()を使い、1つの日付だけに独自の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で保存し、表示するときに変換するのが定番のアドバイスです。

Webページにカレンダーを表示する

日付は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日、時刻は午前0時になります。

date()のよくあるミス

date()の2つ目の引数は、日付の文字列ではなくタイムスタンプでなければなりません。次の行は、

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

ほかにも気をつけたい点が2つあります。mは月でiは分なので、'H:m'は分が欲しいところに月を出力します。またnew DateTimeImmutable('garbage')はfalseを返す代わりに例外を投げるので、ユーザーの入力はtry/catchで包むか、一致しなければfalseを返すDateTimeImmutable::createFromFormat()で解析しましょう。