PHPの日付フォーマット：date()のフォーマット文字一覧

PHPの日付フォーマットは、文字が日付の部品を表す文字列です：date('Y-m-d H:i:s')は2026-03-14 09:05:07のように出力します。Yは4桁の年、mは月、dは日、Hは時（24時間制）、iは分、sは秒で、-、/、:のようにフォーマット文字でないものはそのまま出力されます。同じフォーマット文字列がdate()でもDateTimeImmutable::format()でも使えます。

$formatを変えてRunを押してください。日付は2026年3月14日（土）09:05:07に固定してあるので、各文字が何をするかが正確にわかります。

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

出力：

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

date($format)は現在の瞬間を、date($format, $timestamp)はタイムスタンプを、$date->format($format)は日付のオブジェクトを整形します。strtotime()からタイムゾーンまで、日付についてのそのほかのことはPHPのdate()のページにあります。

日付のフォーマット文字

下の例はすべて、UTCの2026-03-14 09:05:07.123456に対する結果です。

日

週と月

年

時刻

タイムゾーン

完全な日付と時刻

同じ表をライブで確認できます。このブロックは、選んだ日付に対してすべての文字を出力します。自分の誕生日、午後の日付、うるう年の年末などを入れてみてください。

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

フォーマットの中に文字や単語を出力する

フォーマット文字列の中の英字はどれもフォーマット文字として読まれるので、'Today is l'は「Today is」を出力しません。T、o、d、a、y、i、sはすべてフォーマット文字だからです。そのまま出力したい英字の前にはバックスラッシュを置きます。ダブルクォートの文字列では\tがすでにタブ文字なので、バックスラッシュを含むフォーマットにはシングルクォートを使います。

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

出力：

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

よく使う日付フォーマット

ほとんどのコードで必要なフォーマットはほんの一握りです。このブロックはそれらをHTMLの表として出力するので、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>

日付はY-m-dかY-m-d H:i:sで保存して比較しましょう。この順番の文字列は日付と同じ順に並べ替えられますが、d/m/Yの文字列はそうなりません。

ISO 8601、DATE_ATOMなどの標準フォーマット

PHPには、API、フィード、Cookieが期待するフォーマットの定数があります。DATE_ATOM（DateTimeInterface::ATOMも同じ）はISO 8601かつRFC 3339で、JSONのAPIが使うフォーマットです。

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

出力：

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

DATE_ISO8601という定数もありますが、そのオフセットにはコロンがなく（+0000）、ISO 8601はその形では認めていないので、DATE_ATOMを使いましょう。

日本語の日付フォーマット（Y年m月d日）

フォーマット文字でない文字は漢字も含めてそのまま出力されるので、'Y年n月j日'は書いたとおりに動きます。nとjは先頭のゼロを落とし（3月14日）、mとdはゼロを残します（03月14日）。曜日はdate()が英語の名前しか知らないので翻訳できない唯一の部分です。代わりにwの数値を自分の一覧に対応させます。

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

出力：

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

ほかの言語の月の名前や和暦（令和）を含む完全なローカライズには、intl拡張のIntlDateFormatterがロケールのパターンで整形します。使うのはこのページのPHPの文字ではなく、ICUのパターン文字（yyyy、MM、EEEE）です。

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

日付をあるフォーマットから別のフォーマットに変換する

14/03/2026を2026-03-14にするには、DateTimeImmutable::createFromFormat()を使って書かれているフォーマットで文字列を解析し、もう一度整形します。使う文字は表と同じです。フォーマットは!で始めましょう。そうしないと、与えなかったフィールド（ここでは時刻）が現在の瞬間から埋められます。

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

出力：

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

ユーザーが入力した日付では、getLastErrors()からの警告はfalseと同じく不正な日付として扱いましょう。

日付フォーマットのよくあるミス

何度も出てくるバグが3つあります。iのつもりのm、Yとy、そしてstrtotime()に日と月の順番を推測させることです。strtotime()はスラッシュをアメリカ式の月/日の順、ダッシュやドットを日-月の順として読むので、同じ数字が2つの違う日付になります。

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

出力：

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

入力のフォーマットがわかっているなら、strtotime()に推測させずにcreateFromFormat()でそれを伝えましょう。