الدالة date() في PHP: الحصول على التواريخ وتنسيقها وحسابها

تعيد date('Y-m-d') تاريخ اليوم نصًا، مثل 2026-03-14. الوسيط الأول نص تنسيق يمثل فيه كل حرف جزءًا من التاريخ (Y السنة، وm الشهر، وd اليوم، وH:i:s الوقت)، والوسيط الثاني الاختياري طابع زمني 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

تتغير المخرجات في كل مرة تضغط Run، لأنها التاريخ والوقت الحاليان بتوقيت UTC. وكل حرف في نص التنسيق، وطريقة وضع نص عادي بينها، موجودة في صفحة تنسيق التاريخ في PHP.

الطوابع الزمنية: time() وmktime() وstrtotime()

الطابع الزمني Unix هو عدد الثواني منذ 1 يناير 1970 عند منتصف الليل بتوقيت UTC. تعيد time() الطابع الحالي، وتبني mktime(hour, minute, second, month, day, year) طابعًا من أجزاء، وتقرأ strtotime() تاريخًا مكتوبًا بالإنجليزية ('2026-03-14' و'+1 week' و'next monday'). مرّر أي طابع زمني وسيطًا ثانيًا لـ date(). والوسيط الثاني لـ strtotime() هو اللحظة التي تُحسب منها العبارة النسبية؛ ودونه تُحسب من الآن.

<?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) هو 28 فبراير. وقارن النتيجة دائمًا بـ false قبل تمريرها: تطبع date('Y-m-d', false) بهدوء 1970-01-01، تاريخًا لم يقصده أحد.

إضافة أيام إلى تاريخ

لأي شيء يتجاوز الطباعة، استخدم DateTimeImmutable. يأخذ تابعه modify() العبارات نفسها التي تأخذها strtotime() ويعيد تاريخًا جديدًا، ويأخذ add() كائن DateInterval مثل P7D (مدة 7 أيام) أو PT90M (90 دقيقة).

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

لا يوجد 31 فبراير، لذا يقع +1 month على 31 يناير في 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، لذا تستطيع الدالة قبول أي منهما.

الفرق بين تاريخين

تعيد diff() كائن DateInterval. خاصيته days هي العدد الكلي للأيام بين التاريخين، بينما تقسم 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 هو ما تستخدمه لـ «الأيام المتبقية». ولمقارنة تاريخين دون فرق، تعمل العوامل العادية على كائنات التواريخ: $today < $christmas تساوي true.

المناطق الزمنية

تستخدم date() وnew DateTimeImmutable() المنطقة الزمنية الافتراضية، التي تأتي من date.timezone في php.ini (UTC عندما لا تكون مضبوطة). اضبطها للسكربت كله بـ date_default_timezone_set()، أو أعطِ تاريخًا واحدًا 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 وتحوّلها عند عرضها.

عرض تقويم على صفحة ويب

أكثر ما تُطبع التواريخ في 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 (الأحد)، وهو عدد الخلايا الفارغة قبل اليوم الأول، وتعطي format('t') عدد أيام الشهر. وتعيد ! في '!Y-m' ضبط كل حقل لا يذكره التنسيق، فيكون اليوم هو الأول والوقت منتصف الليل.

أخطاء شائعة مع date()

يجب أن يكون الوسيط الثاني لـ date() طابعًا زمنيًا، لا نص تاريخ. هذا السطر:

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

وخطآن آخران يجب الانتباه إليهما: m هو الشهر وi هو الدقائق، لذا تطبع 'H:m' الشهر حيث أردت الدقائق؛ وترمي new DateTimeImmutable('garbage') استثناءً بدل إعادة false، لذا ضع مُدخلات المستخدم داخل try/catch أو حللها بـ DateTimeImmutable::createFromFormat()، التي تعيد false عند عدم التطابق.