الحجز يظهر في اليوم السابق: تواريخ JavaScript وتوقيت UTC
باختصار: إذا اختار الزبون في نموذج الحجز يوم 9 من الشهر، ثم ظهر الحجز في لوحة التحكم أو في رسالة التأكيد على أنه يوم 8، أو اختلف التاريخ بين المتصفح والخادم، فالسبب غالباً في طريقة تعامل JavaScript مع التواريخ دون وقت. توثيق MDN يوضح نقطتين: النص الذي يحمل تاريخاً فقط مثل "2026-11-09" يُفسَّر كوقت UTC، بينما النص الذي يحمل تاريخاً ووقتاً دون إزاحة يُفسَّر كوقت محلي، والدالة toISOString تعيد الوقت دائماً بتوقيت UTC. في الأردن، حيث التوقيت متقدم على UTC بثلاث ساعات، يكفي خلط هذين السلوكين لينزلق التاريخ يوماً للخلف.
كيف تظهر المشكلة في مشروع حقيقي؟
مركز تجميل في إربد يستقبل الحجوزات من نموذج على موقعه. الزبونة تختار التاريخ من حقل التقويم، ثم يرسل الموقع الحجز إلى الخادم. بعد أسابيع لاحظت موظفة الاستقبال أن بعض الحجوزات تظهر في جدول اليوم السابق، فاتصلت بزبونة لتذكيرها بموعد «اليوم»، والزبونة تقول إن موعدها غداً.
المشكلة لا تحدث مع كل الحجوزات، ولا على كل الأجهزة، وهذا ما يجعلها محيرة. هذا مثال توضيحي لحالة شائعة في نماذج الحجز والطلبات، وقد تظهر بالشكل نفسه في تواريخ التوصيل وتواريخ انتهاء الاشتراكات.
ما الذي يقوله التوثيق بالضبط؟
صفحة Date في توثيق MDN تشرح صيغة نصوص التاريخ والوقت المعيارية. التاريخ وحده يمكن أن يكون بصيغة YYYY-MM-DD، والتاريخ مع الوقت يضيف حرف T ثم الساعة والدقائق. ويمكن أن تتبع كل صيغة إزاحة للمنطقة الزمنية.
ثم تأتي الجملة المهمة: عند غياب إزاحة المنطقة الزمنية، تُفسَّر صيغ التاريخ وحده كوقت UTC، وتُفسَّر صيغ التاريخ مع الوقت كوقت محلي. ويذكر التوثيق أن تفسير التاريخ وحده كوقت UTC سببه خطأ تاريخي في المواصفة لم يكن متسقاً مع معيار ISO 8601، لكنه لم يعد قابلاً للتغيير حفاظاً على توافق الويب.
وصفحة Date.parse تعطي أمثلة: النص "2019-01-01" يُفهم ضمنياً كتوقيت UTC لأنه تاريخ فقط، بينما "2019-01-01T00:00:00" دون إزاحة يُضبط على منتصف الليل بالتوقيت المحلي للنظام لأنه يحتوي تاريخاً ووقتاً.
أما صفحة toISOString فتقول إن الدالة تعيد نصاً بصيغة ISO مبسطة، وإن المنطقة الزمنية فيه دائماً UTC، كما يدل على ذلك الحرف Z في آخره.
كيف ينزلق التاريخ يوماً للخلف في الأردن؟
السيناريو الأكثر شيوعاً في الأردن:
- المطور ينشئ تاريخ الحجز كمنتصف ليل بالتوقيت المحلي، مثلاً من مكونات تقويم تعطي يوماً وشهراً وسنة.
- قبل الإرسال إلى الخادم، يحوله إلى نص بالدالة toISOString.
- لأن الأردن متقدم على UTC بثلاث ساعات، منتصف ليل يوم 9 بالتوقيت المحلي يساوي الساعة التاسعة مساء يوم 8 بتوقيت UTC.
- النص المرسل يبدأ بتاريخ يوم 8. الخادم يأخذ أول عشرة أحرف ويحفظ الحجز في يوم 8.
مثال توضيحي آخر: الكود في مكان يقرأ "2026-11-09" كتاريخ فقط فيعامله كـ UTC، وفي مكان آخر يقرأ "2026-11-09T00:00" فيعامله كوقت محلي. الفرق بين القيمتين ثلاث ساعات، وأي مقارنة أو ترتيب بينهما قد يعطي نتيجة غير متوقعة، خصوصاً عند حساب «حجوزات اليوم».
ولماذا لا يحدث مع كل الأجهزة؟ لأن النتيجة تعتمد على المنطقة الزمنية المضبوطة في جهاز الزبون. زبونة مسافرة أو هاتف بإعدادات منطقة مختلفة قد يعطي نتيجة أخرى.
الحل الأول: التاريخ وحده يبقى نصاً
إذا كان الحجز «يوماً» لا «لحظة»، مثل موعد في عيادة يُحدد وقته لاحقاً، أو تاريخ توصيل، فلا تحوله إلى كائن Date أصلاً. توثيق MDN لحقل التاريخ في HTML يذكر أن قيمة الحقل تُوحّد بصيغة yyyy-mm-dd، وأنها تحتوي السنة والشهر واليوم دون وقت. أرسل هذا النص كما هو إلى الخادم، وخزّنه في عمود تاريخ لا عمود وقت.
القاعدة: ما لا يحتاج وقتاً لا يدخل في حسابات المناطق الزمنية.
الحل الثاني: لا تستخدم toISOString لاستخراج التاريخ المحلي
إذا كان لديك كائن Date بالتوقيت المحلي وتريد التاريخ كما يراه الزبون، فاستخرج السنة والشهر واليوم بالدوال المحلية وركّب النص بنفسك، أو استخدم أداة تنسيق تحدد المنطقة الزمنية صراحة. toISOString مفيدة لتخزين لحظة زمنية بتوقيت UTC، وليست لاستخراج «اليوم المحلي».
الحل الثالث: إذا كان الحجز لحظة، أرسل المنطقة معه
إذا كان الحجز يتضمن ساعة محددة، مثل موعد الساعة الرابعة عصراً، فأرسل التاريخ والوقت مع إزاحة المنطقة الزمنية أو مع اسم المنطقة. التوثيق يذكر أن كل صيغة يمكن أن تتبعها إزاحة. بهذا لا يبقى للخادم أي تخمين.
الخادم أيضاً له منطقة زمنية
المشكلة لا تقتصر على المتصفح. كثير من الخوادم المستأجرة مضبوطة افتراضياً على توقيت UTC. إذا كان الخادم يحسب «حجوزات اليوم» بتاريخ الخادم لا بتاريخ الأردن، فإن الحجوزات بين منتصف الليل والساعة الثالثة فجراً بتوقيت عمّان قد تُحسب على اليوم السابق في التقارير اليومية. اسأل المطور: بأي منطقة زمنية يحسب الخادم بداية اليوم ونهايته؟ وهل تقرير المبيعات اليومي يبدأ من منتصف الليل في عمّان أم في UTC؟
هذا مهم خصوصاً للمطاعم ومحلات الحلويات التي تستقبل طلبات بعد منتصف الليل في رمضان أو في المواسم، فقد يظهر جزء من مبيعات الليلة في تقرير يوم آخر.
اتفقوا على قاعدة واحدة في الفريق
أغلب هذه الأخطاء تولد عندما يكتب مطوران أجزاء مختلفة بافتراضات مختلفة. اكتبوا قاعدة قصيرة في وثيقة المشروع:
- التواريخ دون وقت: نص بصيغة YYYY-MM-DD من البداية إلى النهاية.
- اللحظات الزمنية: تُخزن بتوقيت UTC مع معرفة المنطقة الأصلية.
- العرض للزبون والموظف: يُحوَّل إلى توقيت الأردن عند العرض فقط.
- لا قص لأول عشرة أحرف من نص UTC لاستخراج التاريخ.
كيف تختبر؟
- احجز موعداً في أول يوم من الشهر وآخر يوم منه، وتحقق من ظهوره في اليوم الصحيح في لوحة التحكم.
- احجز من هاتف بمنطقة زمنية مختلفة، مثل منطقة دولة أوروبية، وقارن.
- افحص تقرير «حجوزات اليوم» قرب منتصف الليل وبعده بقليل.
- افحص رسالة التأكيد بالبريد أو الرسائل، ومن أين تأخذ التاريخ.
- راجع أي تصدير للحجوزات، لأن أدوات التصدير قد تحوّل التواريخ بطريقتها.
أسئلة شائعة
ليش الحجز بيطلع يوم قبل اليوم اللي اختاره الزبون؟
غالباً لأن الكود حوّل منتصف الليل المحلي إلى نص بتوقيت UTC بالدالة toISOString، والأردن متقدم على UTC بثلاث ساعات، فيصبح التاريخ اليوم السابق.
ليش "2026-11-09" غير "2026-11-09T00:00"؟
بحسب MDN، التاريخ وحده دون إزاحة يُفسَّر كـ UTC، والتاريخ مع الوقت دون إزاحة يُفسَّر كوقت محلي.
هل أخزن تاريخ الموعد كنص؟
إذا كان يوماً دون ساعة، نعم: نص بصيغة YYYY-MM-DD في عمود تاريخ، دون تحويل إلى كائن وقت.
ليش المشكلة ما بتصير عند كل الزبائن؟
لأن النتيجة تعتمد على المنطقة الزمنية المضبوطة في جهاز كل زبون.
إذا كانت حجوزاتك تظهر في الأيام الخطأ، اكتب لنا ونتتبع التواريخ في نظامك معك.
المصادر
- https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date
- https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse
- https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
- https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input/date