تنسيق التاريخ في PHP: كل محارف التنسيق في date()

تنسيق التاريخ في PHP نص تمثل فيه الحروف أجزاء التاريخ: تطبع date('Y-m-d H:i:s') شيئًا مثل 2026-03-14 09:05:07. Y السنة بأربعة أرقام، و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 ثوابت للتنسيقات التي تتوقعها الواجهات البرمجية والخلاصات وملفات تعريف الارتباط. DATE_ATOM (وأيضًا DateTimeInterface::ATOM) هو ISO 8601 وRFC 3339، التنسيق الذي تستخدمه واجهات 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 بأنماط الإعدادات المحلية. وتستخدم حروف أنماط 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() تخمّن.