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

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

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.

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

أمثلة

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

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

  يعطي الأحد 1 جمادى الأولى 1446هـ الموافق 3 نوفمبر 2024م
• لتاريخ اليوم:

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

  يعطي الأحد 1 جمادى الأولى 1446هـ الموافق 3 نوفمبر 2024 (غريغوري) و 21 أكتوبر 2024 (يولياني) و13 آبان 1403 (جلالي) وو2 تيشفان 5785 (عبري)

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

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

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

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

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

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

  يعطي الخميس 1 محرم 1هـ الموافق 15 يوليو 622م
• لتاريخ نزول آية ﴿الْيَوْمَ أَكْمَلْتُ لَكُمْ دِينَكُمْ وَأَتْمَمْتُ عَلَيْكُمْ نِعْمَتِي وَرَضِيتُ لَكُمُ الْإِسْلَامَ دِينًا﴾ [المائدة: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	يحدد هل ستمرر النتيجة على قالب وقت، إذاكنت لا تستخدم رموز خاصة بقالب وقت فعينه إلى "لا" مثال لا	بولياني	اختياري