مولّد تقويم شهري قابل للطباعة

تعمل أداة المتصفح مجانًا على جهازك؛ أما API المدفوعة مسبقًا فتتقاضى $0.002 عن كل عنصر ناجح عندما تحتاج الخوادم وSDK إلى العقد نفسه.

السنة والشهر وأول يوم أسبوع قابل للضبط

لا يستدعي المحرك كائن Date في النظام المضيف إطلاقًا، لذلك لا تتبدل النتائج مع المناطق الزمنية أو إعدادات اللغة؛ ويُحسب يوم الأسبوع لليوم الأول بطريقة Sakamoto، ويتبع طول فبراير قاعدة الكبس الميلادية (القابلية للقسمة على أربعة، إلا سنوات القرن ما لم تكن قابلة للقسمة على أربعمئة أيضًا). أرسل عددين صحيحين إلزاميين: year ضمن النطاق الميلادي المدعوم، وmonth بواحد ليناير وحتى اثني عشر لديسمبر. الحقل الاختياري first_weekday عدد صحيح من صفر إلى ستة، حيث يعني الصفر الأحد، والواحد الاثنين، والستة السبت؛ احذفه للإبقاء على تخطيط بدء الأسبوع بالأحد الشائع في كثير من التقويمات الجدارية المطبوعة في الولايات المتحدة. تُقبل الأسماء البديلة y وyr لحقل year، وm وmon لحقل month، وweek_start أو start_weekday لأصل الأسبوع عندما تكون موثقة. الحقول الناقصة، والقيم غير الصحيحة، والسنوات خارج الحدود المنشورة، وfirst_weekday خارج صفر إلى ستة، وأي شهر أقل من واحد أو أكبر من اثني عشر تُطلق invalid_input كي يصحح المُستدعي الطلب بدلًا من استلام شهر مُرحَّل بصمت قد يُفسد طباعة ورقة كاملة.

قراءة الأسابيع والترويسات وحشو الأيام

ولأن الحشو قيم null صريحة، لا تضطر أدوات العرض أبدًا إلى إعادة حساب إزاحات الأعمدة بنفسها. عند النجاح، تعيد الاستجابة السنة والشهر بعد التسوية، وسلسلة month_name بالإنجليزية للعناوين، وdays_in_month كعدد صحيح لطول ذلك الشهر. يُبيّن العلم is_leap_year ما إذا كانت السنة كبيسة وفق التقويم الميلادي حتى عندما لا يكون الشهر فبراير. يصف first_weekday وfirst_weekday_name أصل الأسبوع الذي طلبته؛ أما first_of_month_weekday واسمه فيحددان موضع اليوم الأول على المقياس المطلق من الأحد إلى السبت كي تُبرز الواجهات البداية الحقيقية دون تخمين. weekday_headers مصفوفة من سبعة عناصر لأسماء أيام الأسبوع الإنجليزية مُداوَرة بحيث يطابق العمود الأول قيمة first_weekday — مثلًا من الاثنين إلى الأحد عندما تكون first_weekday واحدًا. مصفوفة weeks هي جوهر العقد: كل عنصر فيها له week_index ومصفوفة days بطول سبعة، حيث كل خانة إما رقم يوم من واحد إلى days_in_month أو null لحشو الفراغات قبل الأول وبعد الأخير. week_count هو عدد الصفوف، وعادة ما يكون من أربعة إلى ستة. تكون calendar دائمًا gregorian وmethod دائمًا month_calendar لتفريع مستقر في الاختبارات. استخدم weekday_headers لعناوين أعمدة الجدول، وweeks لخلايا جسم الشبكة القابلة للطباعة، وdays_in_month عندما تحتاج أيضًا إلى تسمية توضيحية بطول الشهر.

استخدام API والتسعير وسير عمل الطباعة والحدود العملية

أرسل جسم JSON يتضمن الحقلين الصحيحين الإلزاميين year وmonth، مع first_weekday الاختياري عندما تحتاج إلى تخطيط يبدأ بالاثنين أو تخطيط إقليمي آخر. استخدم API المدفوعة مسبقًا عندما يحتاج خط إنتاج طباعة أو مولّد فصول دراسية أو منتج جدولة أو مخطط متعدد المستأجرين إلى عقد مستقر برصيد KIT بسعر $0.002 لكل عنصر ناجح؛ فإخفاقات التحقق لا تستهلك الرصيد أبدًا بعد أن يرفض المحرك الحمولة. اقرن نقطة النهاية هذه بفاحص عدد أيام الشهر عندما تحتاج إلى الطول فقط، أو بأدوات بناء الدعوات عندما تكون الخطوة التالية ملف حدث لا شبكة شهر — فتلك نوايا بحث ومنتجات مختلفة. يمكن لمؤلفي SDK تحويل weeks إلى جداول HTML أو خلايا PDF عمودًا بعمود باستخدام weekday_headers كوسوم thead وخانات null كخلايا فارغة جاهزة لأنماط طباعة CSS.