פורמט תאריך ב-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. התאריך קבוע לשבת, 14 במרץ 2026 בשעה 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() ועד אזורי זמן, נמצא בעמוד date() ב-PHP.

תווי פורמט תאריך

כל דוגמה למטה היא התוצאה עבור 2026-03-14 09:05:07.123456 ב-UTC.

יום

שבוע וחודש

שנה

שעה

אזור זמן

תאריך ושעה מלאים

אותה טבלה, חיה: הבלוק הזה מדפיס כל תו עבור תאריך שתבחרו. שימו את יום ההולדת שלכם, תאריך אחר הצהריים, או תאריך בסוף שנה מעוברת:

<?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 יש קבועים לפורמטים ש-APIs, פידים ועוגיות מצפים להם. DATE_ATOM (וגם DateTimeInterface::ATOM) הוא ISO 8601 ו-RFC 3339, הפורמט ש-APIs של 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

פלט:

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

ללוקליזציה מלאה, כולל שמות חודשים בשפות אחרות והעידן היפני (令和), IntlDateFormatter של הרחבת intl מעצבת עם תבניות locale. היא משתמשת באותיות התבנית של ICU (yyyy, MM, EEEE), לא בתווי PHP שבעמוד הזה:

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

טעויות נפוצות בפורמטי תאריך

שלושה באגים מופיעים שוב ושוב: m במקום שבו התכוונו ל-i, Y מול y, ונתינה ל-strtotime() לנחש את סדר היום והחודש. strtotime() קוראת לוכסנים בסדר האמריקאי חודש/יום ומקפים או נקודות בסדר יום-חודש, ולכן אותן ספרות נותנות שני תאריכים שונים:

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

כשאתם יודעים את הפורמט של הקלט, אמרו אותו עם createFromFormat() במקום לתת ל-strtotime() לנחש.