العمل مع التواريخ والوقت في PHP: من الألف إلى الياء - دليل شامل

العمل مع التواريخ والوقت في PHP: من الألف إلى الياء

العمل مع التواريخ والوقت من أكثر المهام شيوعًا في تطوير الويب. سواء كان عرض تاريخ النشر، حساب عمر المستخدم، تسجيل الأحداث أو إنشاء تقويم - توفر PHP أدوات قوية ومرنة. في هذه المقالة سنغطي جميع الجوانب: من الدوال البسيطة إلى النهج الكائني مع فئة DateTime، بما في ذلك المناطق الزمنية والأمثلة العملية.

الدوال الأساسية: date() و time()

مجموعة الدوال الأساسية للعمل مع التواريخ تشمل time() و date(). ترجع الدالة time() الطابع الزمني الحالي لنظام Unix (عدد الثواني منذ 1 يناير 1970). تقوم الدالة date() بتنسيق هذا الطابع إلى شكل قابل للقراءة البشرية.

الحصول على التاريخ والوقت الحاليين

أبسط طريقة لعرض التاريخ الحالي:

<?php\necho date('Y-m-d H:i:s'); // 2025-04-10 15:30:45\n?>

التنسيق باستخدام date()

تأخذ الدالة date() معلمتين: التنسيق وطابع زمني اختياري. أشهر رموز التنسيق:

\n
• d — يوم الشهر (01–31)
\n
• m — الشهر (01–12)
\n
• Y — السنة بتنسيق 4 أرقام
\n
• H — الساعات بتنسيق 24 ساعة (00–23)
\n
• i — الدقائق (00–59)
\n
• s — الثواني (00–59)
\n

مثال للإخراج مع نص عربي:

<?php\necho 'اليوم ' . date('d.m.Y') . '، الوقت ' . date('H:i');\n// اليوم 10.04.2025، الوقت 15:30\n?>

فئة DateTime: النهج الكائني

للعمليات المعقدة يُوصى باستخدام فئة DateTime. فهي بديهية، تدعم المناطق الزمنية وتُبسط التعامل مع التواريخ.

إنشاء كائن DateTime

يمكن إنشاء الكائن بعدة طرق:

<?php\n// التاريخ والوقت الحاليين\n$now = new DateTime();\necho $now->format('Y-m-d H:i:s'); // 2025-04-10 15:30:45\n\n// تاريخ محدد\n$date = new DateTime('2025-12-31 23:59:59');\necho $date->format('d.m.Y'); // 31.12.2025\n\n// باستخدام تنسيق نسبي\n$nextWeek = new DateTime('+1 week');\necho $nextWeek->format('Y-m-d');\n?>

تعديل التاريخ: modify()

تسمح الطريقة modify() بإضافة أو طرح الفترات بسهولة:

<?php\n$date = new DateTime('2025-04-10');\n$date->modify('+10 days');\necho $date->format('d.m.Y'); // 20.04.2025\n\n$date->modify('-1 month');\necho $date->format('d.m.Y'); // 20.03.2025\n?>

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

تجاهل المناطق الزمنية خطأ شائع. تقدم PHP طريقتين للتحكم بها: عالميًا عبر date_default_timezone_set() ومحليًا عبر كائن DateTimeZone.

الإعداد العالمي

قم بتعيين المنطقة الزمنية في بداية السكريبت:

<?php\ndate_default_timezone_set('Europe/Moscow');\necho date('H:i'); // الوقت بتوقيت موسكو\n?>

الإعداد المحلي لـ DateTime

يمكن أن يكون لكل كائن DateTime منطقته الزمنية الخاصة:

<?php\n$timezone = new DateTimeZone('Asia/Vladivostok');\n$date = new DateTime('now', $timezone);\necho $date->format('H:i'); // الوقت في فلاديفوستوك\n\n// تغيير المنطقة لكائن موجود\n$date->setTimezone(new DateTimeZone('Europe/Moscow'));\necho $date->format('H:i'); // الوقت المحول\n?>

الفرق بين التواريخ: DateInterval

تسمح فئة DateInterval والطريقة diff() بحساب الفرق بين تاريخين.

حساب الفرق

<?php\n$start = new DateTime('2025-01-01');\n$end = new DateTime('2025-12-31');\n$interval = $start->diff($end);\n\necho $interval->days; // 364 (العدد