مقالات معمّقة حول التكنولوجيا التي تشكّل المستقبل.

حساب التواريخ بلا مكتبات: درس من يوم القيامة

عنوان قديم من 1960 يخفي درسًا عمليًا: حساب التواريخ سهل في العرض، وصعب أن يصيب دون مكتبات برمجية.

دراسة من منتصف القرن العشرين فيها منحنيات على سبورة، وشبكات تقويم، وآلة حاسبة ميكانيكية
منحنى يوم القيامة القديم أقل أهمية من آلية التقويم اللازمة لتسمية يوم الأسبوع الخاص به.

تداول مؤخرًا عنوان قديم غريب: مادة نُشرت في مجلة Science عام 1960 تشير إلى يوم الجمعة 13 نوفمبر 2026 وتصفه بيوم القيامة. النبوءة نفسها ليست الجزء المثير للمبرمجين. المثير أن التاريخ فعلًا يوافق يوم جمعة، والوصول إلى هذه الإجابة يجبرك على حساب التواريخ: قواعد السنة الكبيسة، وأطوال الشهور، واستثناءات القرون، والسنوات السالبة، والفرق الهادئ بين صيغة تبهر الناس وكود يصمد في الإنتاج.

الورقة وراء العنوان صادرة عن Heinz von Foerster وزملائه، ولها طابع الاستفزاز. درسوا نمو عدد السكان، وزعموا أنه أسوأ من النمو الأسي، وطابقوه بمنحنى زائدي، وتركوا المقام يقترب من الصفر. فكانت النتيجة تفردًا بتاريخ مثالي للصحف الشعبية. يختلف المؤرخون وعلماء الديموغرافيا حول جديتها؛ فهي تُقرأ نصف كتحذير ونصف كنكتة من شخص يعرف تمامًا وقع يوم جمعة الثالث عشر الدرامي.

ما أعود إليه دائمًا هو الحرفية المختبئة تحت السطح. قبل أن تسخر من التنبؤ، تحقق من يوم الأسبوع. وقبل التحقق من يوم الأسبوع، حدّد أي تقويم تقصد: هل هو الغريغوري الممتد للخلف؟ أم التواريخ المدنية الفعلية في بلد محدد؟ أم ترقيم السنوات الفلكي، أم اتفاقية عدم وجود السنة صفر التي يستخدمها المؤرخون؟ معظمنا يمد يده إلى datetime أو java.time أو chrono ويمضي. وهذا غالبًا صحيح. لكن تنفيذ الأمر بدون مكتبات يظل من أفضل تمارين الدقة الصغيرة في البرمجة، لأن القواعد محدودة وقديمة ومليئة بالفخاخ.

عنوان يوم القيامة مشكلة تقويم

ابدأ بالادعاء نفسه: 13 نوفمبر 2026 يوم جمعة. يمكنك التحقق من ذلك في REPL خلال ثوانٍ. الغرض من الحساب اليدوي ليس السرعة، بل كشف النموذج. التقويم آلة حالات ذات انتقالات غير منتظمة: معظم الشهور تتقدم بثلاثين أو واحد وثلاثين يومًا، وفبراير يتغير شكله في السنوات الكبيسة، والسنوات التي تنتهي بـ00 ترفض الكبس إلا إذا قبلت القسمة على أربعمئة، والنمط كله يتكرر كل أربعمئة سنة في التقويم الغريغوري. وعندما ترى هذه الدورة، يتوقف حساب يوم الأسبوع عن كونه تنجيمًا ويصبح حسابًا معياريًا على دورة مصممة بعناية.

يقدم أسلوب Conway للقيامة خوارزمية بشرية سهلة التذكر. في كل قرن يوجد يوم مرساة؛ ولعقد 2000 هو الثلاثاء. بالنسبة لسنة مثل 2026، خذ الرقمين الأخيرين، أي 26. اقسمه على 12 لتحصل على اثنتي عشرة مجموعة من السنوات وباقي 2، ثم أضف عدد السنوات الكبيسة داخل الباقي، وهو صفر هنا. اثنان زائد اثنان زائد صفر يساوي أربعة، والثلاثاء زائد أربعة يساوي السبت. هذا هو «يوم القيامة» للسنة، أي اليوم المشترك بين المعالم السهلة مثل 4/4 و6/6 و8/8 و10/10 و12/12، وآخر يوم من فبراير، و7 نوفمبر. إذا كان 7 نوفمبر 2026 يوم سبت، فإن 13 نوفمبر يبعد عنه ستة أيام، أي الجمعة. مسرحي بما يكفي لعنوان صحفي، وميكانيكي بما يكفي لحسابه على منديل ورقي.

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

لماذا ينكسر حساب أيام الأسبوع في الكود الحقيقي

نادرًا ما تعلن أخطاء التقويم عن نفسها بصخب. تظهر على هيئة بريد تجديد يُرسل قبل يوم بعد يوم كبيسة، أو فاتورة تستثني نهاية الفترة كل فبراير، أو مهمة أسبوعية تنحرف بعد حدود قرن لم يتوقعه أحد، أو مجموعة بيانات تاريخية تعني فيها السنة صفر شيئًا في ISO 8601 وشيئًا آخر في فهرس متحف. الفجوة بين المواصفة والتنفيذ هي بالضبط المكان الذي تعيش فيه هذه العيوب، لأن الجميع يظن أن القاعدة بديهية حتى تصطدم قاعدتان بديهيتان ببعضهما.

حالة الحدود الكلاسيكية هي سنة 2000: قابلة للقسمة على مئة، لكنها كبيسة لأنها قابلة للقسمة على أربعمئة. أما سنة 1900 فلم تكن كذلك، وسنة 2100 لن تكون كذلك. كثير من فحوص الكبس المكتوبة يدويًا تتذكر year % 4 == 0 وتتوقف عند هذا الحد، وهو صحيح مع معظم السنوات التي تهتم بها الشركات الناشئة، لكنه خاطئ عند أفق زمني أطول. الأنظمة المالية والأرشيفات والبنية التحتية أصبحت تعيش لفترات طويلة، لذلك لم تعد الآفاق الطويلة نظرية.

  • ضغط قاعدة الكبس: y % 4 بدل القاعدة الغريغورية الكاملة.
  • فخاخ ترقيم الشهور: يناير بشريًا هو واحد، لكن كثيرًا من الواجهات البرمجية تبدأ من صفر، وZeller يريد مارس أولًا.
  • دلالات السنوات السالبة: السنة صفر في الترقيم الفلكي مقابل 1 قبل الميلاد يليها 1 بعد الميلاد.
  • ترقيم أيام الأسبوع: يبدأ بالأحد أو الاثنين أو السبت حسب الصيغة.
  • إصلاح التقويم: تبني قواعد غريغوري قبل أن تتبناها منطقة ما تاريخيًا.
  • القسمة الصحيحة: لغة C تقرّب نحو الصفر، بينما يحتاج حساب التقويم غالبًا إلى القسمة نحو الأسفل (floor).

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

صيغة Zeller وقيامة Conway وشكل المعادلة

تطابق Zeller مع حيلة Conway هو الابن الأقدم والأكثر تعقيدًا. بالنسبة للتقويم الغريغوري يُكتب كثيرًا بحيث يكون مارس الشهر 14، وأبريل 15، ويُعامل يناير وفبراير كالشهرين 13 و14 من السنة السابقة. مع اليوم q، والشهر m، وسنة القرن K، والقرن الصفري J، من الصيغ الشائعة: h = (q + floor(13(m+1)/5) + K + floor(K/4) + floor(J/4) + 5J) mod 7، حيث تعني h = 0 يوم السبت. تعمل الصيغة، لكنها حقل ألغام من الاتفاقيات.

توجد صيغ منشورة متعددة، بعضها بنقاط صفر مختلفة لأيام الأسبوع، وبعضها للتقويم اليولياني، وبعضها يضيف حدودًا بدل أن يطرحها. إذا نسخت واحدة من منتدى، فقد تحصل على صيغة صحيحة لعام 1901 إلى 2099 وخاطئة عند الأطراف، أو صحيحة فقط إذا كانت لغتك تقرّب القسمة الصحيحة بالطريقة التي افترضها الكاتب. لهذا لا أحب تقديم Zeller ككود إنتاج. إنه رائع لفهم البنية: حد خطي لليوم، وتصحيح للشهر يقارب الأطوال غير المنتظمة، وحد للسنة، وتصحيحات للكبس، وتصحيح للقرن. لكنه أقل روعة حين يضطر أحد المشرفين على الكود إلى الهندسة العكسية لمعرفة أي اتفاقية استُخدمت.

يُحسّن أسلوب Conway للذاكرة البشرية، ويُحسّن Zeller للأناقة الجبرية. أما الكود الإنتاجي فيجب أن يُحسَّن لقابلية التدقيق. هذه أهداف مختلفة. بمعنى تصميم اللغات، هذا هو الفرق بين ماكرو ذكي ودالة مملة تحمل الثوابت في أسمائها. نحتاج إلى دوال مملة أكثر تحمل ثوابتها في أسمائها.

تروس تقويم متشابكة مع ترس شباط المتغير داخل حلقات القرن
التقويم آلة: منتظم بما يكفي للنمذجة، وغير منتظم بما يكفي لمعاقبة الاختصارات.

نواة غريغورية صغيرة يمكنك تدقيقها

إذا احتجت منطق أيام الأسبوع في كود مقيّد، فأفضل قاعدة أساسية عندي هي بناء days-from-civil الذي وضعه Howard Hinnant. يحوّل التاريخ الغريغوري إلى عدد أيام تسلسلي منسوب إلى 1970-01-01، ثم يصبح يوم الأسبوع حسابًا بالباقي انطلاقًا من خميس معروف. التنفيذ قصير، لكن كل ثابت له سبب. يتجنب جداول الشهور المتفرعة بإزاحة السنة بحيث يصبح مارس أول شهر، فيقع يوم الكبيسة في نهاية السنة المزاحة، حيث لا يعبث بما قبله.

typedef long long i64;
/* Gregorian proleptic calendar; March is treated as the first month. */
static i64 days_from_civil(i64 y, int m, int d) {
y -= m <= 2;
i64 era = (y >= 0 ? y : y - 399) / 400;      /* floor-ish 400-year era */
int yoe = (int)(y - era * 400);              /* year of era, 0..399 */
int mp = m + (m > 2 ? -3 : 9);               /* Mar=0 ... Feb=11 */
int doy = (153 * mp + 2) / 5 + d - 1;        /* day of shifted year */
int doe = yoe * 365 + yoe / 4 - yoe / 100 + doy;
return era * 146097 + doe - 719468;          /* 1970-01-01 == 0 */
}
/* Returns 0=Sunday, 1=Monday, ... 6=Saturday. */
static int weekday_gregorian(i64 y, int m, int d) {
i64 z = days_from_civil(y, m, d);
int r = (int)((z + 4) % 7);                  /* 1970-01-01 was Thursday */
if (r < 0) r += 7;
return r;
}

رقم 153 يستحق الاحترام. عبر الشهور المزاحة من مارس إلى فبراير تتناوب الأطوال بنمط قريب من ثلاثين وواحد وثلاثين يومًا، والتعبير (153 * mp + 2) / 5 يرمز إلى عدد الأيام التراكمية قبل كل شهر دون جدول بحث. التعبير 146097 هو عدد أيام دورة غريغورية مدتها أربعمئة سنة: 146000 يوم من أربعة قرون، زائد 97 يوم كبيسة. طرح 719468 يعيد مركز العدّ إلى حقبة Unix. ليس في هذا شيء غامض؛ إنه المواصفة التقويمية مقطرة إلى حساب.

هنا تهم اختيارات الأنواع. استخدم أعدادًا صحيحة موقعة واسعة للأيام التسلسلية. وكن صريحًا بشأن الغريغوري الممتد للخلف إن كان هذا ما تنفذه. قرر هل تُرفض الأيام خارج النطاق مثل 31 أبريل أم تُطبّع؛ أنا أفضل الرفض للتواريخ المدنية لأن التدوير الصامت يخفي أخطاء المصدر. وإذا قبلت مدخلات قبل الميلاد، فاذكر أي ترقيم تستخدم قبل أول عملية طرح. تبدو هذه أمورًا تخص المكتبات، لكن الانضباط نفسه ينطبق داخل كود firmware أو إجراء مخزّن حيث لا يرغب أحد في الاعتراف بأن التواريخ معقدة.

المناطق الزمنية ليست حسابًا تقويميًا

يثبت يوم الأسبوع فقط بعد تحديد مقياس الزمن والموقع. اجتماع في الساعة 00:30 في طوكيو لا يزال هو اليوم المدني السابق في سان فرانسيسكو. إذا كان نظامك يخزن اللحظات، فحوّلها عبر قاعدة بيانات المناطق الزمنية قبل أن تسأل عن يوم الأسبوع. وإذا كان نظامك يخزن تواريخ مدنية، فلا تحوّلها بلا تفكير إلى لحظات دون ربطها بمنطقة. نمط الفشل دقيق: يمكن لخدمتين أن تتفقا على الطابع الزمني وتختلفا على اليوم.

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

الثواني الكبيسة طبقة أخرى يحب الناس جرّها إلى نقاشات أيام الأسبوع. تجاهلها في حساب يوم الأسبوع المدني. فأيام الأسبوع تتبع أيام التقويم، لا الزمن الذري المنعّم. إذا نعّمت الثواني الكبيسة أو استخدمت ساعة أحادية الاتجاه للمدد، فلا بأس، لكن لا تدعه يتسرب إلى سؤال «هل هذا يوم جمعة؟». يوم الجمعة حقيقة اجتماعية.

اختبارات تستحق مكانًا في CI

يكتسب كود التواريخ الثقة عبر تجهيزات عدائية، لا بالإحساس. ضع الحالات الصعبة بجانب الدالة. اختبر 1900-02-28 و1900-03-01 كيومين متجاورين بلا كبيسة بينهما. اختبر 2000-02-29 لأنه موجود. اختبر 2099-12-31 وهو ينتقل إلى 2100، حيث تخطئ قاعدة السنوات الأربع وحدها. اختبر 1970-01-01 على أنه خميس إذا استخدمت تلك الحقبة. اختبر السنوات السالبة إذا كنت تدّعي دعمها، واختبر أنك ترفض المدخلات المشوهة قبل الحساب.

اختبارات الخصائص مفيدة إذا كانت الخصائص صادقة. إضافة يوم واحد يجب أن تزيد يوم الأسبوع بواحد modulo سبعة لأي تاريخ صالح. أربعمئة سنة غريغورية يجب أن تحتوي 146097 يومًا وتعود إلى يوم الأسبوع نفسه. وداخل قرن غير كبيس، يجب أن تشترك معالم القيامة في يوم أسبوع واحد فقط إذا كان تنفيذك متسقًا. لا تختبر مقابل مكتبة وُلدت من الفهم الخاطئ نفسه الذي تحاول تجنبه؛ ثبّت النتائج المتوقعة من المواصفة أو من جداول مشتقة بشكل مستقل.

يكون روتين التاريخ صحيحًا حين تكون اتفاقياته مملة وصريحة ومختبرة عند الحدود التي يغيّر فيها التقويم رأيه.

بالنسبة لتاريخ القيامة نفسه، الإجابة المتوقعة بسيطة بما يكفي لتكتبها في تعليق ضمن الكود: 2026-11-13 يعطي الجمعة وفق قواعد الغريغوري الممتد للخلف. ثم أضف المسار المحيط: 2026-11-07 معلم قيامة وهو سبت، و2026-02-28 سبت، و2027-02-28 أحد بعد سنة عادية، و2028-02-29 موجود لأن 2028 قابلة للقسمة على أربعة وغير قابلة للقسمة على مئة. هذه المجموعات الصغيرة تلتقط أخطاء الواحد الزائد أو الناقص أفضل من مليون حالة عشوائية.

بلاطات تقويم تنقلب بين الحالات مع تظليل أحمر عند حالات الحدود
التجهيزات الجيدة تستهدف الحدود: أيام الكبيسة، وسنوات القرن، ومراسي الحقبة، والمدخلات المشوهة.

الدرس القديم للنماذج الجديدة

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

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

إذن نعم، جمعة الثالث عشر قادمة في موعدها. لا حاجة لنهاية العالم. الخوف الحقيقي هو مدى سهولة أن يشحن فريق منطقًا لأيام الأسبوع يعمل تقريبًا، مبنيًا على تطابقات نصف متذكرة وافتراضات لم يكتبها أحد. افعل الشيء البسيط بدقة: نفّذ دورة الأربعمئة سنة، وارفض التواريخ المستحيلة، وأبقِ اللحظات منفصلة عن التسميات المدنية، واترك للمشرفين اللاحقين أثرًا من الثوابت يمكنهم التحقق منها. يوم القيامة يصنع اختبار وحدة أفضل من التنبؤ.