عرض مصدر قالب:تاريخ منسق/شرح

{{صفحة توثيق فرعية}}
{{Lua|module:Hijri|module:Hijri/core|module:Hijri/Configuration|module:Hijri/adjustment data|module:Hijri/umalqura data|module:Hijri/adjusted data}}
يستخدم هذا القالب لإخراج تاريخ منسق يشابه في عمله القالب الافتراضي {{قا|وقت}} مع المميزات التالية:
# دعم [[تقويم أم القرى]] المعتمد في [[السعودية]] والعديد من دول العالم الإسلامي، وهو من أدق التقاويم وأقربها للرؤية الشرعية، وذلك من السنة 1318 إلى 1500 هجرية.
# التقويم الاصطلاحي (المجدول) مبرمج على ما الخوارزمية التي قررها شيخ الفلكيين [[صالح العجيري]] في كتبه وبخاصة كتاب تقويم القرون، وهو موافق للتقويم الهجري في برامج مايكروسوفت، والخوارزمية المتبعة يسميها البعض الخوارزيمة الكويتية، ولعل سبب التسمية الفلكي الكويتي [[صالح العجيري]]، هذه الخورازمية تختلف عن الخورازمية المتبعة في أغلب البرامج المفتوحة المصدر منها ويكيبيديا ومكتبة icu العالمية.
# تدعم الوحدة تقديم وتأخير التاريخ بطريقة سليمة وخالية من اللبس والخطأ لأن قابلية التعديل من أصل الوحدة وليس شيئًا طارئًا، وقد وضعت التعديلات في وحدة مستقلة وهي [[وحدة:Hijri/adjustment data]].
# يدعم القالب التاريخ الهجري كمدخل للتاريخ وتكون المخرجات بالتقويم الهجري أو اليولياني أو الغريغوري أو التقاويم الأخرى المدعومة من ويكيبيديا وهي الجلالي (الهجري شمسي) والعبري.
# تدعم الوحدة إخراج عدد أيام الشهر الهجري وكذلك رقم اليوم في السنة الهجرية، وهذان لا يدعمها القالب الأساسي في ويكيبيديا.
# في الوحدة ميزة فريدة وهي إمكانية تعديل التاريخ الهجري بيوم الأسبوع لمعرفة المقابل الغريغوري أو اليولياني الدقيق للتاريخ الهجري.
# تدعم الوحدة بدائل عربية لرموز التاريخ.
==الاستعمال==
يدعم القالب إخراج التاريخ بأكثر من تقويم بحسب الصيغة المدخلة.
===التاريخ المدخل===
التاريخ المدخل له ثلاث حالات:
# تاريخ معين باليوم والشهر والسنة والتقويم المستخدم، وفي هذه يجب تعيين مدخلات <code>ي</code> <code>ش</code> <code>س</code> لليوم الشهر والسنة على التوالي بالأرقام فقط، وتعيين المدخل <code>التقويم</code> بأحد قيم التقويم المتاحة، وفي حالة عدم تعيين التقويم فسيعينه القالب إلى هجري للسنوات قبل 1500 وغريغوري فيما بعد1500.
#:<pre>{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=10|ش=12|س=1442|التقويم=هجري}}</pre>
#:وفي حالة كون التقويم هجريًّا ورغبت في تعديل التقويم بالتاريخ الدقيق اعتمادًا على يوم الأسبوع فيعطى للقالب بصيغة نصية (السبت-الجمعة) في المدخل <code>يوم الأسبوع</code>.
#:<pre>{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=14|ش=7|س=32|يوم الأسبوع=الجمعة|التقويم=هجري}}</pre>
# صيغة نصية للتاريخ بالتقويم الغريغوري حصرًا بصيغة مفهومة للغة php بحسب [[https://www.php.net/manual/en/datetime.formats.date.php هذا الشرح]]، وتكون إما في المدخل الثاني أو في المدخل <code>التاريخ</code>.
#:<pre>{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|2022-01-01}}</pre>
# تاريخ اليوم، وفي هذه الحالة تكون الصيغة مثل:
#:<pre>{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم}}</pre>

===الإخراج===
يدعم القالب رموز الإخراج القياسية في لغة php الخاصة بالتقويم الغريغوري بالإضافة إلى التقاويم الإضافية التي يدعمها برنامج ميدياويكي وهي التقويم الجلالي والتقويم اليهودي والمشروحة في [[https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions##time هنا]] مع التعديلات التالية:
* رموز الإخراج الهجري تتم وفق القالب وليس وفق قالب #وقت المدمج في برنامج ميدياويكي.
* أضيف إلى رموز الإخراج الهجري بعض الرموز.
* يدعم القالب رموز إخراج عربية لتسهيل كتابة الصيغة وتذكر رموزها.
وهي:

:{|class="wikitable"
! ع !! L !! التوضيح !! المثال
|-
|<code>ي</code>||<code>j</code> ||لل{{أحمر|ي}}وم (1-31)، ويمكن إضافة صفر بعدها هكذا <code>ي0</code> لتكون موسدة بأصفار هكذا (01-31). ||1-31
|-
|<code>ش</code>|| <code>F</code>||لاسم ال{{أحمر|ش}}هر.|| محرم - يناير
|-
|<code>ر</code>|| <code>n</code>||ل{{أحمر|ر}}قم الشه{{أحمر|ر}}، (1-12)، ويمكن إضافة صفر بعدها هكذا <code>ر0</code> لتكون موسدة بأصفار هكذا (01-12).||1-12
|-
|<code>س</code>||<code>Y</code>||لرقم ال{{أحمر|س}}نة.|| 1-1400
|-
|<code>ل</code>||<code>t</code>||لعدد أيام الشهر، واللام مشتقة من كلمة هلا{{أحمر|ل}}.|| 1-31
|-
|<code>ة</code>||<code>z</code>|||لرقم اليوم في السن{{أحمر|ة}} (يبدأ من صفر) ليوم 1-1 اتباعاً لنظام ويكيبيديا والمتفرع عن قواعد php.|| 0-365
|-
|<code>ع</code>||<code>l</code>||ليوم الأسبو{{أحمر|ع}}.||السبت إلى الجمعة
|-
|}
:*ويجب أن يسبق هذه البدائل علامة المدة <code>~</code> ثم رمز التقويم المطلوب للرمز العربي أو <code>x</code> ثم رمز التقويم اللاتيني، رموز التقويم هي:
:{|class="wikitable"
! ع !! L !! نوع التقويم !! توضيح
|-
|<code>~ه</code>||<code>xm</code>|| للتقويم ال{{أحمر|ه}}جري||
|-
|<code>~ي</code>||<code>xu</code>|| للتقويم ال{{أحمر|ي}}ولياني|| وهو التقويم الميلادي المعتمد حتى سنة 1582 حيث تم التحول إلى التقويم الغريغوري من بعض الدول.
|-
|<code>~غ</code>||<code>xg</code>||للتقويم ال{{أحمر|غ}}ريغوري|| وهو المعتمدة عالميًا كتقويم مدني ومعتمد في لغة php حتى للتوارخ التي قبل 1582.
|-
|<code>~م</code>||<code>xw</code>|| للتقويم ال{{أحمر|م}}يلادي أو الغربي|| وهو يولياني حتى 1582-10-4 ثم يبدأ من 1582-10-15 بالتقويم الغريغوري وهو المطبق فعليًا في القارة الأوربية والدول التابعة للكنيسة الكاثوليكية الغربية.
|}
* يمكن تحديد طريقة حساب التقويم الهجري عبر المدخلة <code>التقويم الهجري</code> وهي إحدى هذه الطرق الثلاث:
## <code>أم القرى</code> وهو تقويم أم القرى صافيًا بدون أية تعديلات في الفترة من 1318 إلى 1500 وهجري اصطلاحي في غيرها.
## <code>اصطلاحي</code> أو <code>مجدول</code>، وفق خوارزميات الفلكي الكويتي [[صالح العجيري]].
## <code>معدل</code> وهو مطابق لتقويم أم القرى مع اعتماد التعديلات المنصوص عليها في [[وحدة:Hijri/adjustment data]].
* يمكن إجبار القالب على عدم تمرير الصيغة على قالب #وقت المدمج على المدخل <code>تمرير على وقت=لا</code>.

==أمثلة==
* لتاريخ اليوم: <pre>{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم}}</pre> يعطي {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم}}
* لتاريخ اليوم: <pre>{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مس (غريغوري) و ~يي ~يش ~يس (يولياني) وxij xiF xiY (جلالي) ووxjj xjF xjY (عبري)}}</pre> يعطي {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مس (غريغوري) و ~يي ~يش ~يس (يولياني) وxij xiF xiY (جلالي) ووxjj xjF xjY (عبري)}}

* للتاريخ الموافق لأول رمضان: <pre>{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=1|ش=9|س=1443}}</pre> يعطي {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=1|ش=9|س=1443}}
* للتاريخ الموافق لأول السنة الميلادية: <pre>{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=1|ش=1|س=2022}}</pre> يعطي {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=1|ش=1|س=2022}}
* للتاريخ الموافق لأول سنة هجرية باليولياني: <pre>{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=1|ش=1|س=1|التقويم=هجري}}</pre> يعطي {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=1|ش=1|س=1|التقويم=هجري}}
* لتاريخ نزول آية {{قرآن|الْيَوْمَ أَكْمَلْتُ لَكُمْ دِينَكُمْ وَأَتْمَمْتُ عَلَيْكُمْ نِعْمَتِي وَرَضِيتُ لَكُمُ الْإِسْلَامَ دِينًا|س=5|آ=3}}: <pre>{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=9|ش=12|س=10|التقويم=هجري}}</pre> يعطي {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=9|ش=12|س=10|التقويم=هجري}}
* لتاريخ وفاة العباس بن عبد المطلب: <pre>{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=14|ش=7|س=32|التقويم=هجري}}</pre> يعطي {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=14|ش=7|س=32|التقويم=هجري}}

لكن نصت المصادر التاريخية على أن وفاته كانت يوم الجمعة مما يعني أن التقويم الاصطلاحي غير موافق للرؤية في ذلك الشهر فنلجأ للتعديل بيوم الأسبوع:
<pre>{{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=14|ش=7|س=32|يوم الأسبوع=الجمعة|التقويم=هجري}}</pre> فيعطي {{تاريخ منسق|~هع ~هي ~هش ~هسهـ الموافق ~مي ~مش ~مسم|ي=14|ش=7|س=32|يوم الأسبوع=الجمعة|التقويم=هجري}}

<templatedata>
{
	"params": {
		"الصيغة": {
			"aliases": [
				"1",
				"format"
			],
			"label": "صيغة التاريخ",
			"description": "صيغة التاريخ المطلوبة وفقًا للرموز المشروحة",
			"example": "~هع ~هي ~هش ~هس هـ الموافق ~مي ~مش ~مس م",
			"type": "string",
			"suggestedvalues": [
				"~هع ~هي ~هش ~هس هـ الموافق ~مي ~مش ~مس م",
				"~مع ~مي ~مش ~مس الموافق ~هي ~هش ~هسهـ",
				"~مس-~مر0-~مي0",
				"~هع ~هي ~هش ~هسهـ"
			],
			"required": true
		},
		"التقويم": {
			"aliases": [
				"المصدر",
				"تقويم المصدر",
				"Cal"
			],
			"label": "التقويم المصدر للتاريخ المدخل",
			"description": "نوع التقويم الذي المصدر الذي تم إدخال بيانات السنة والشهر واليوم له",
			"example": "هجري",
			"type": "string",
			"suggestedvalues": [
				"هجري",
				"أم القرى",
				"معدل",
				"هجري اصطلاحي",
				"غريغوري",
				"يولياني",
				"ميلادي"
			],
			"default": "هجري",
			"suggested": true
		},
		"س": {
			"aliases": [
				"السنة",
				"سنة",
				"y",
				"year"
			],
			"label": "السنة",
			"description": "السنة",
			"example": "1443",
			"type": "number",
			"suggested": true
		},
		"ش": {
			"aliases": [
				"الشهر",
				"شهر",
				"m",
				"month"
			],
			"label": "الشهر",
			"description": "الشهر (بالرقم)",
			"example": "12",
			"type": "number",
			"suggestedvalues": [
				"1",
				"2",
				"3",
				"4",
				"5",
				"6",
				"7",
				"8",
				"9",
				"10",
				"11",
				"12"
			],
			"suggested": true
		},
		"ي": {
			"aliases": [
				"اليوم",
				"يوم",
				"d",
				"day"
			],
			"label": "اليوم",
			"description": "رقم اليوم في الشهر",
			"example": "1-31",
			"type": "number",
			"suggestedvalues": [
				"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"
			],
			"suggested": true
		},
		"يوم الأسبوع": {
			"aliases": [
				"wday"
			],
			"label": "يوم الأسبوع",
			"description": "يوم الأسبوع بالاسم، يستخدم مع مع التقويم الهجري لضبط التعديل على يوم الأسبوع",
			"example": "السبت-الجمعة",
			"type": "line",
			"suggestedvalues": [
				"السبت",
				"الأحد",
				"الإثنين",
				"الثلاثاء",
				"الأربعاء",
				"الخميس",
				"الجمعة"
			],
			"suggested": true
		},
		"التقويم الهجري": {
			"aliases": [
				"نوع التقويم الهجري",
				"hijri Calendar type"
			],
			"label": "نوع تقويم الإخراج الهجري",
			"description": "نوع التقويم الهجري المستعمل في الإخراج",
			"example": "أم القرى",
			"type": "line",
			"suggestedvalues": [
				"هجري",
				"معدل",
				"أم القرى",
				"اصطلاحي"
			],
			"default": "معدل"
		},
		"التاريخ": {
			"aliases": [
				"2",
				"تاريخ",
				"date"
			],
			"label": "التاريخ المدخل",
			"description": "تاريخ الإدخال بالتقويم الغريغوري بصيغة كاملة مفهوم للغة php",
			"example": "2022-02-28",
			"type": "line"
		},
		"تمرير على وقت": {
			"aliases": [
				"pass mw time"
			],
			"label": "تمرير على قالب وقت",
			"description": "يحدد هل ستمرر النتيجة على قالب وقت، إذاكنت لا تستخدم رموز خاصة بقالب وقت فعينه إلى \"لا\"",
			"example": "لا",
			"type": "boolean"
		}
	},
	"description": "يخرج التاريخ منسقًا بعدة تقاويم.",
	"format": "inline"
}
</templatedata>
<includeonly>[[تصنيف:قوالب حساب التواريخ]]</includeonly>