قالب:تاريخ منسق/شرح

قالب:Lua يستخدم هذا القالب لإخراج تاريخ منسق يشابه في عمله القالب الافتراضي {{وقت}} مع المميزات التالية:

1. دعم تقويم أم القرى المعتمد في السعودية والعديد من دول العالم الإسلامي، وهو من أدق التقاويم وأقربها للرؤية الشرعية، وذلك من السنة 1318 إلى 1500 هجرية.
2. التقويم الاصطلاحي (المجدول) مبرمج على ما الخوارزمية التي قررها شيخ الفلكيين صالح العجيري في كتبه وبخاصة كتاب تقويم القرون، وهو موافق للتقويم الهجري في برامج مايكروسوفت، والخوارزمية المتبعة يسميها البعض الخوارزيمة الكويتية، ولعل سبب التسمية الفلكي الكويتي صالح العجيري، هذه الخورازمية تختلف عن الخورازمية المتبعة في أغلب البرامج المفتوحة المصدر منها ويكيبيديا ومكتبة icu العالمية.
3. تدعم الوحدة تقديم وتأخير التاريخ بطريقة سليمة وخالية من اللبس والخطأ لأن قابلية التعديل من أصل الوحدة وليس شيئًا طارئًا، وقد وضعت التعديلات في وحدة مستقلة وهي وحدة:Hijri/adjustment data.
4. يدعم القالب التاريخ الهجري كمدخل للتاريخ وتكون المخرجات بالتقويم الهجري أو اليولياني أو الغريغوري أو التقاويم الأخرى المدعومة من ويكيبيديا وهي الجلالي (الهجري شمسي) والعبري.
5. تدعم الوحدة إخراج عدد أيام الشهر الهجري وكذلك رقم اليوم في السنة الهجرية، وهذان لا يدعمها القالب الأساسي في ويكيبيديا.
6. في الوحدة ميزة فريدة وهي إمكانية تعديل التاريخ الهجري بيوم الأسبوع لمعرفة المقابل الغريغوري أو اليولياني الدقيق للتاريخ الهجري.
7. تدعم الوحدة بدائل عربية لرموز التاريخ.

الاستعمال

يدعم القالب إخراج التاريخ بأكثر من تقويم بحسب الصيغة المدخلة.

التاريخ المدخل

التاريخ المدخل له ثلاث حالات:

1. تاريخ معين باليوم والشهر والسنة والتقويم المستخدم، وفي هذه يجب تعيين مدخلات ي ش س لليوم الشهر والسنة على التوالي بالأرقام فقط، وتعيين المدخل التقويم بأحد قيم التقويم المتاحة، وفي حالة عدم تعيين التقويم فسيعينه القالب إلى هجري للسنوات قبل 1500 وغريغوري فيما بعد1500.

   {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=10|ش=12|س=1442|التقويم=هجري}}

   وفي حالة كون التقويم هجريًّا ورغبت في تعديل التقويم بالتاريخ الدقيق اعتمادًا على يوم الأسبوع فيعطى للقالب بصيغة نصية (السبت-الجمعة) في المدخل يوم الأسبوع.

   {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=14|ش=7|س=32|يوم الأسبوع=الجمعة|التقويم=هجري}}

2. صيغة نصية للتاريخ بالتقويم الغريغوري حصرًا بصيغة مفهومة للغة php بحسب هذا الشرح، وتكون إما في المدخل الثاني أو في المدخل التاريخ.

   {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|2022-01-01}}

3. تاريخ اليوم، وفي هذه الحالة تكون الصيغة مثل:

   {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم}}

الإخراج

يدعم القالب رموز الإخراج القياسية في لغة php الخاصة بالتقويم الغريغوري بالإضافة إلى التقاويم الإضافية التي يدعمها برنامج ميدياويكي وهي التقويم الجلالي والتقويم اليهودي والمشروحة في هنا مع التعديلات التالية:

• رموز الإخراج الهجري تتم وفق القالب وليس وفق قالب #وقت المدمج في برنامج ميدياويكي.
• أضيف إلى رموز الإخراج الهجري بعض الرموز.
• يدعم القالب رموز إخراج عربية لتسهيل كتابة الصيغة وتذكر رموزها.

وهي:

ع	L	التوضيح	المثال
ي	j	للقالب:أحمروم (1-31)، ويمكن إضافة صفر بعدها هكذا ي0 لتكون موسدة بأصفار هكذا (01-31).	1-31
ش	F	لاسم القالب:أحمرهر.	محرم - يناير
ر	n	لقالب:أحمرقم الشهقالب:أحمر، (1-12)، ويمكن إضافة صفر بعدها هكذا ر0 لتكون موسدة بأصفار هكذا (01-12).	1-12
س	Y	لرقم القالب:أحمرنة.	1-1400
ل	t	لعدد أيام الشهر، واللام مشتقة من كلمة هلاقالب:أحمر.	1-31
ة	z	لرقم اليوم في السنقالب:أحمر (يبدأ من صفر) ليوم 1-1 اتباعاً لنظام ويكيبيديا والمتفرع عن قواعد php.	0-365
ع	l	ليوم الأسبوقالب:أحمر.	السبت إلى الجمعة

• ويجب أن يسبق هذه البدائل علامة المدة ~ ثم رمز التقويم المطلوب للرمز العربي أو x ثم رمز التقويم اللاتيني، رموز التقويم هي:

ع	L	نوع التقويم	توضيح
~ه	xm	للتقويم القالب:أحمرجري
~ي	xu	للتقويم القالب:أحمرولياني	وهو التقويم الميلادي المعتمد حتى سنة 1582 حيث تم التحول إلى التقويم الغريغوري من بعض الدول.
~غ	xg	للتقويم القالب:أحمرريغوري	وهو المعتمدة عالميًا كتقويم مدني ومعتمد في لغة php حتى للتوارخ التي قبل 1582.
~م	xw	للتقويم القالب:أحمريلادي أو الغربي	وهو يولياني حتى 1582-10-4 ثم يبدأ من 1582-10-15 بالتقويم الغريغوري وهو المطبق فعليًا في القارة الأوربية والدول التابعة للكنيسة الكاثوليكية الغربية.

• يمكن تحديد طريقة حساب التقويم الهجري عبر المدخلة التقويم الهجري وهي إحدى هذه الطرق الثلاث:

1. 1. أم القرى وهو تقويم أم القرى صافيًا بدون أية تعديلات في الفترة من 1318 إلى 1500 وهجري اصطلاحي في غيرها.
   2. اصطلاحي أو مجدول، وفق خوارزميات الفلكي الكويتي صالح العجيري.
   3. معدل وهو مطابق لتقويم أم القرى مع اعتماد التعديلات المنصوص عليها في وحدة:Hijri/adjustment data.

• يمكن إجبار القالب على عدم تمرير الصيغة على قالب #وقت المدمج على المدخل تمرير على وقت=لا.

أمثلة

• لتاريخ اليوم:

  {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم}}

  يعطي الخميس 9 شوال 1445هـ الموافق 18 أبريل 2024م
• لتاريخ اليوم:

  {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مس (غريغوري) و ~يي ~يش ~يس (يولياني) وxij xiF xiY (جلالي) ووxjj xjF xjY (عبري)}}

  يعطي الخميس 9 شوال 1445هـ الموافق 18 أبريل 2024 (غريغوري) و 5 أبريل 2024 (يولياني) و30 فروردین 1403 (جلالي) وو10 نيزان 5784 (عبري)

• للتاريخ الموافق لأول رمضان:

  {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=1|ش=9|س=1443}}

  يعطي السبت 1 رمضان 1443هـ الموافق 2 أبريل 2022م
• للتاريخ الموافق لأول السنة الميلادية:

  {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=1|ش=1|س=2022}}

  يعطي السبت 28 جمادى الأولى 1443هـ الموافق 1 يناير 2022م
• للتاريخ الموافق لأول سنة هجرية باليولياني:

  {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=1|ش=1|س=1|التقويم=هجري}}

  يعطي الخميس 1 محرم 1هـ الموافق 15 يوليو 622م
• لتاريخ نزول آية ﴿الْيَوْمَ أَكْمَلْتُ لَكُمْ دِينَكُمْ وَأَتْمَمْتُ عَلَيْكُمْ نِعْمَتِي وَرَضِيتُ لَكُمُ الْإِسْلَامَ دِينًا﴾[[[سورة قالب:اسم السورة 5|5]]:3]:

  {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=9|ش=12|س=10|التقويم=هجري}}

  يعطي الجمعة 9 ذو الحجة 10هـ الموافق 6 مارس 632م
• لتاريخ وفاة العباس بن عبد المطلب:

  {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=14|ش=7|س=32|التقويم=هجري}}

  يعطي الأحد 14 رجب 32هـ الموافق 17 فبراير 653م

لكن نصت المصادر التاريخية على أن وفاته كانت يوم الجمعة مما يعني أن التقويم الاصطلاحي غير موافق للرؤية في ذلك الشهر فنلجأ للتعديل بيوم الأسبوع:

{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=14|ش=7|س=32|يوم الأسبوع=الجمعة|التقويم=هجري}}

فيعطي الجمعة 14 رجب 32هـ الموافق 15 فبراير 653م

يخرج التاريخ منسقًا بعدة تقاويم.

وسائط القالب[تحرير بيانات القالب]

هذا القالب يفضل التنسيق بنفس السطر للوسائط.

وسيط		وصف	نوع	حالة
صيغة التاريخ	الصيغة 1 format	صيغة التاريخ المطلوبة وفقًا للرموز المشروحة القيم المقترحة ~هع ~هي ~هش ~هس هـ الموافق ~مي ~مش ~مس م ~مع ~مي ~مش ~مس الموافق ~هي ~هش ~هسهـ ~مس-~مر0-~مي0 ~هع ~هي ~هش ~هسهـ مثال ~هع ~هي ~هش ~هس هـ الموافق ~مي ~مش ~مس م	نص	مطلوب
التقويم المصدر للتاريخ المدخل	التقويم المصدر تقويم المصدر Cal	نوع التقويم الذي المصدر الذي تم إدخال بيانات السنة والشهر واليوم له القيم المقترحة هجري أم القرى معدل هجري اصطلاحي غريغوري يولياني ميلادي غيابي هجري مثال هجري	نص	مقترح
السنة	س السنة سنة y year	السنة مثال 1443	رقم	مقترح
الشهر	ش الشهر شهر m month	الشهر (بالرقم) القيم المقترحة 1 2 3 4 5 6 7 8 9 10 11 12 مثال 12	رقم	مقترح
اليوم	ي اليوم يوم d day	رقم اليوم في الشهر القيم المقترحة 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 مثال 1-31	رقم	مقترح
يوم الأسبوع	يوم الأسبوع wday	يوم الأسبوع بالاسم، يستخدم مع مع التقويم الهجري لضبط التعديل على يوم الأسبوع القيم المقترحة السبت الأحد الإثنين الثلاثاء الأربعاء الخميس الجمعة مثال السبت-الجمعة	سطر	مقترح
نوع تقويم الإخراج الهجري	التقويم الهجري نوع التقويم الهجري hijri Calendar type	نوع التقويم الهجري المستعمل في الإخراج القيم المقترحة هجري معدل أم القرى اصطلاحي غيابي معدل مثال أم القرى	سطر	اختياري
التاريخ المدخل	التاريخ 2 تاريخ date	تاريخ الإدخال بالتقويم الغريغوري بصيغة كاملة مفهوم للغة php مثال 2022-02-28	سطر	اختياري
تمرير على قالب وقت	تمرير على وقت pass mw time	يحدد هل ستمرر النتيجة على قالب وقت، إذاكنت لا تستخدم رموز خاصة بقالب وقت فعينه إلى "لا" مثال لا	بولياني	اختياري