عرض مصدر قالب:العمر بالأيام/شرح

{{صفحة توثيق فرعية}}
<!-- Place categories where indicated at the bottom of this page and interwikis at Wikidata -->
{{استخدام واسع|{{العمر بالأيام/شرح/عداد}}}}
{{Lua|Module:Age}}
{{اختصار قالب|مساعدة دولية}}

This template returns the number of days between two dates. Dates may be input either as full dates or as year, month and day. Omitted parameters to their current value.
gives 
== الاستخدام ==
====Full dates====
To use, type:
:{|
|-
|<code><nowiki>{{العمر بالأيام|date1|date2}}</nowiki></code>&nbsp;||(number of days between dates 1 and 2),
|-
|<code><nowiki>{{العمر بالأيام|date1}}</nowiki></code>            ||(number of days since date 1) or
|-
|<code><nowiki>{{العمر بالأيام||date2}}</nowiki></code>           ||(number of days until date 2)
|}

Examples:
* {{#invoke:DemoTemplate|age in days|19 Aug 2008|4 Sep 2010}}
* {{#invoke:DemoTemplate|age in days|27 May 2002}}
* {{#invoke:DemoTemplate|age in days||{{#time:j M Y|+ 15 months}}}}

====Year, month and day====
To use, type:
:{|
|-
|<code><nowiki>{{العمر بالأيام|year1|month1|day1|year2|month2|day2}}</nowiki></code>&nbsp;||(number of days between dates 1 and 2),
|-
|<code><nowiki>{{العمر بالأيام|year1|month1|day1}}</nowiki></code>                         ||(number of days since date 1) or
|-
|<code><nowiki>{{العمر بالأيام||||year2|month2|day2}}</nowiki></code>                      ||(number of day until date 2)
|}

Or with named parameters:
:{|
|-
|<code><nowiki>{{العمر بالأيام|month1= |day1= |year1= |month2= |day2= | year2=}}</nowiki></code>&nbsp;||(number of days between dates 1 and 2),
|-
|<code><nowiki>{{العمر بالأيام|month1= |day1= |year1=}}</nowiki></code>                               ||(number of days since date 1) or
|-
|<code><nowiki>{{العمر بالأيام|month2= |day2= | year2=}}</nowiki></code>                              ||(number of day until date 2)
|}

Examples:
* {{#invoke:DemoTemplate|age in days|2007|5|24|2008|4|23}}
* {{#invoke:DemoTemplate|age in days|2007|5|24}}

===Sorting===
By adding {{وسيط|sortable|on}} a sort key will be added to the output for use in sortable tables.  The sort key is produced by {{قا|nts}} and is based on the SI unit of time (the second).

===Formatting===
Three styles of formatting are possible.
:{|
|-
|{{وسيط|format|raw}}         ||gives unformatted numbers with hyphens as minus signs<ref>Negative days will occur if the first date is after the second.</ref> (for use in further calculations).
|-
|{{وسيط|format|commas}}&nbsp;||gives numbers formatted with commas (using <code><nowiki>{{formatnum:}}</nowiki></code>) and true minus signs.
|-
|{{وسيط|format|gaps}}        ||gives numbers formatted with thin spaces (using {{قا|val}}) and true minus signs.
|}

For reasons of retrospective compatibility, the default when inputting dates as year, month and day is {{وسيط|format|raw}}; however when inputting dates in full it is {{وسيط|format|commas}}.

:Note
{{مراجع}}

===Showing the unit===
The default is not to show units.  To show the unit ("day", days" or "d") use {{وسيط|show unit}}.

:{|
|-
|{{وسيط|show unit|abbr}}&nbsp;||adds "d" after the number of days.
|-
|{{وسيط|show unit|full}}      ||adds "day" or "days" after the number of days as appropriate.
|}

===Rounding===
The template rounds down to the nearest number of full days.

===Time zones===
As noted above, date parameters left undefined default to their current value.  Note that this is the current UTC value.  Instead of leaving the parameter blank, however, an offset may be added, {{بدون لف|for example, <code><nowiki>{{العمر بالأيام|28 December 2007|+ 5 hours 45 min}}</nowiki></code>}} will give the number of days since the [[قائمة ملوك نيبال]] was deposed.{{محل شك}} Note that this will only work when entering full dates {{بدون لف|(e.g. <code><nowiki>{{العمر بالأيام|2007|12|28|+ 5 hours 45 min}}</nowiki></code>}} will produce an error message).

== طالع أيضاً ==

* [[Wikipedia:Age calculation templates]]
* {{قا|Duration in days}}
* {{قا|وقت مضى}}

{{قوالب الميلاد والوفاة والعمر|age}}
<includeonly>{{sandbox other||
[[تصنيف:قوالب حساب التواريخ]]
[[تصنيف:قوالب إحصاء التاريخ]]
}}</includeonly>