عرض مصدر قالب:ساعة/شرح

{{صفحة توثيق فرعية}}
{{Lua|Module:time}}
{{Tlx|ساعة}} يعرض هذا القالب الوقت الحالي في منطقة زمنية محددة مسبقاً، يتم حساب الوقت على أساس [[توقيت عالمي منسق|التوقيت العالمي المنسق]] للمنطقة الزمنية المحددة مع الأخذ بعين الاعتبار إذا ما كان [[توقيت صيفي|التوقيت الصيفي]] نشط حالياً في المنطقة الزمنية أم لا. يعتمد هذا القالب على [[وحدة:Time]].

== وسائط ==
:<code>|''<nowiki><time zone></nowiki>''</code> – '''القيمة الأولى''' : تحدد المنطقة الزمنية، إذا لم تحدد ستكون تلقائياً UTC.
:{{وسيط قالب|df}} '''القيمة الثانية:''' – تنسيق التاريخ؛ هذه المعلمة تأخذ واحدة من أربع قيم لاحقة، أما غيرها من القيم فيتم تجاهلها:
::{{وسيط قالب|df|dmy}} – يحدد تنسيق التاريخ كالتالي: "يوم شهر سنة".
::{{وسيط قالب|df|mdy}} – يحدد التنسيق "شهر يوم، سنة" وهو التنسيق الافتراضي إذا لم يتم تحديده.
::{{وسيط قالب|df|iso}} – ينتج "التاريخ / الوقت" في شكل مقارب تماماً لتنسيق "[[أيزو 8601]]"، (الثواني) يتم إغفالها.
::{{وسيط قالب|df|y}} – يعرض تنسيق التاريخ كما {{وسيط قالب|df|dmy}}
:{{وسيط قالب|dst}} – عند تعيينها ل <code>no</code> تؤدي إلى تعطيل حساب التوقيت الصيفي للمنطقة الزمنية، القيم الأخرى يتم تجاهلها. مفيدة لمناطق داخل المنطقة الزمنية التي لا تتقيد التوقيت الصيفي. على سبيل المثال [[أريزونا]].

== الاستخدام ==
عادة، كل ما هو مطلوب هو:
:<code><nowiki>{{</nowiki>time|''<TZ>''}}</code> حيث أن <code>''<TZ>''</code> واحدة من اختصارات المناطق الزمنية.
::<code><nowiki>{{ساعة|MST}}</nowiki></code>
:::{{ساعة|MST}}
لتغيير تنسيق التاريخ:
:<code><nowiki>{{ساعة|MST|df=y}}</nowiki></code>
::{{ساعة|MST|df=y}}
:<code><nowiki>{{ساعة|MST|y}}</nowiki></code>
::{{ساعة|MST|y}}
:<code><nowiki>{{ساعة|MST|dmy}}</nowiki></code>
::{{ساعة|MST|dmy}}
:<code><nowiki>{{ساعة|MST|iso}}</nowiki></code>
::{{ساعة|MST|iso}}

=== المناطق الزمنية المدعومة ===
قائمة اختصارات المناطق الزمنية المعتمدة حالياً:
{{Div col|colwidth=10em}}
* [[Australian Central Standard Time|ACST]]
* [[Australian Eastern Standard Time|AEST]]
* [[Alaska Standard Time|AKST]]
* [[في أي مكان على الأرض]]{{Efn-ua|name=non-standard|Not standard time zones, these are included on a whim of the programmer; AoE is 'Anywhere on Earth', 'IDLE' and 'IDLW' are International Date Line East and West}}
* [[توقيت أطلنطي موحد]]
* [[Australian Western Standard Time|AWST]]
* [[توقيت بنغلاديش]]
* [[التوقيت في الصين]]
* [[توقيت وسط أوروبا]]
* {{Ill-WD2|توقيت تشامرو|id=Q3446496}}
* [[المنطقة الزمنية الوسطى|منطقة زمنية وسطى]]
* [[توقيت شرق أوروبا]]
* [[منطقة زمنية شرقية|منطقة زمنية شرقية (أمريكا الشمالية)]]
* [[توقيت غرينيتش]]
* [[Time in Ireland|GMT-IE]]{{Efn-ua|[[Irish Standard Time]]. The abbreviation, IST, is also used for [[توقيت الهند]]. Irish Standard Time occurs in the summer. For these reasons, the template uses GMT-IE as the time zone abbreviation for Ireland.}}
* [[Time in the United Kingdom|GMT-UK]]{{Efn-ua|[[توقيت غرينيتش]] does not observe daylight saving time. In the United Kingdom GMT is observed in winter but shifts to [[توقيت صيفي بريطاني]]. The abbreviation BST is also used by [[توقيت بنغلاديش]]. To differentiate year-round GMT from GMT as observed in the UK, use GMT-UK.}}
* [[Hawaii–Aleutian Time Zone|HAST]]
* IDLE{{Efn-ua|name=non-standard}}
* IDLW{{Efn-ua|name=non-standard}}
* {{Ill-WD2|توقيت إركوتسك|id=Q2347353}}
* [[توقيت الهند]]
* [[توقيت اليابان]]
* {{Ill-WD2|توقيت كراسنويارسك|id=Q2351310}}
* [[توقيت موسكو|MSK]]
* [[المنطقة الزمنية الجبلية|MST]]
* [[Newfoundland Standard Time|NST]]
* [[توقيت نيوزيلندا|NZST]]
* [[Omsk Time|OMST]]
* [[Kamchatka Time|PETT]]
* PMST{{Efn-ua|[[سان بيير وميكلون]] Standard Time}}
* [[زمن منطقة المحيط الهادئ|PST]]
* [[توقيت سامارا|SAMT]]
* [[Srednekolymsk Time|SRET]]
* [[توقيت كالينينغراد|USZ1]]
* [[توقيت عالمي منسق]]
* {{Ill-WD2|توقيت فلاديفوستوك|id=Q632994}}
* [[توقيت غرب أوروبا]]
* WGT{{Efn-ua|Western Greenland Time}}
* [[توقيت إندونيسيا]]
* [[توقيت إندونيسيا]]
* [[توقيت إندونيسيا]]
* [[Yakutsk Time|YAKT]]
* [[توقيت يكاترينبورغ|YEKT]]
{{Div col end}}
{{Notelist-ua}}

=== ازاحة UTC ===
لعرض الوقت بالتوقيت العالمي المنسق كما في منطقة زمنية:
:<code><nowiki>{{ساعة|UTC+03:00}}</nowiki></code>
::{{ساعة|UTC+03:00}}

=== المناطق الزمنية العسكرية / البحرية ===
To display the time at a particular [[military time zones|military]] or [[nautical time zone]],<ref>{{استشهاد ويب |مسار=http://astro.ukho.gov.uk/nao/miscellanea/WMTZ/ |عنوان=World Time Zone Map |موقع=HM Nautical Almanac Office |تاريخ=February 2016}}</ref> use the time zone's alpha designation:
:<code><nowiki>{{ساعة|M}}</nowiki></code>
::{{ساعة|M}}
Some military and nautical time zone designators are extended with an asterisk (*), a dagger (†), or double dagger (‡). When writing this template for designators that are extended with a dagger or double dagger, use '+' and '++' respectively:
:<code><nowiki>{{ساعة|M++}}</nowiki></code>
::{{ساعة|M++}}
:<code><nowiki>{{ساعة|M+}}</nowiki></code>
::{{ساعة|M+}}

=== التوقيت الصيفي ===
Daylight saving time (DST) calculations are automatic for those time zones where it is observed. There are locales that do not observe DST within time zones where it is generally observed. To render the correct time for a non-observant locale, set {{وسيط قالب|dst|no}}:
:<code><nowiki>{{ساعة|MST|dst=no}}</nowiki></code>
::{{ساعة|MST|dst=no}} – [[time in Arizona]]
:<code><nowiki>{{ساعة|MST}}</nowiki></code>
::{{ساعة|MST}} – but, time on the [[محمية نافاجو]] in Arizona

The opposite case is not supported. For places like [[قاعدة ثول الجوية]] in Greenland, which observes US DST rules while WGT observes EU DST rules, a time zone properties table will be needed in Module:Time. See §[[#Adding a new time zone|Adding a new time zone]].

== رسائل الخطأ ==
{{Tld|ساعة}} can produce several error messages. These are:
:<span style="font-size:100%" class="error"><nowiki>{{time}</nowiki>} – unknown timezone</span> – the time zone positional parameter is not one of the supported time zone abbreviations. To resolve this error check the parameter's spelling or add the time zone's properties to the module. See §[[#Adding a new time zone|Adding a new time zone]].
:<span style="font-size:100%" class="error"><nowiki>{{ساعة}}</nowiki> – error calculating dst timestamps</span> – indicates an internal error because one or more of the following time zone properties is malformed: UTC offset, DST begin or end definition. To resolve this error make sure that the time zone's properties are correct.
:<span style="font-size:100%" class="error"><nowiki>{{ساعة}}</nowiki> – incomplete definition for...</span> – indicates an internal error because one or more of the following time zone properties is missing: DST begin or end definition, DST event time, time zone article. To resolve this error supply the missing properties.

== Adding a new time zone ==
{{Tld|ساعة}} uses [[وحدة:Time]]. In that module, is a table of tables, the data structure that specifies the properties of the individual time zones. A blank time zone properties table has this form:
<syntaxhighlight lang="text">[''] = {
 abbr = '', 
 dst_abbr = '',
 utc_offset = '',
 df = '',
 dst_begins = '',
 dst_ends = '',
 dst_time = '',
 dst_e_time = '',
 article = ''
},</syntaxhighlight>

To add a new time zone to Module:Time, add the appropriate information inside the single quotes. If a property does not apply, leave the quotes empty. The rules for each property are:
:<code><nowiki>['']</nowiki></code> – (required) the abbreviation of a time zone's standard time; must be lower case; this is the value that will be used in the template's time zone pararameter
:<code><nowiki>abbr = ''</nowiki></code> – (required) the abbreviation of a time zone's standard time as it will be rendered by the template
:<code><nowiki>dst_abbr = ''</nowiki></code> – the abbreviation of a time zone's daylight saving or summer time as it will be rendered by the template
:<code><nowiki>utc_offset = ''</nowiki></code> – (required) the offset in hours and minutes from [[ت ع م±00:00]]؛ has the form: <code><nowiki>utc_offset = '<sign>hh:mm'</nowiki></code> where <code><sign></code> may be <code>+</code> (optional) or <code>-</code> (required for time zones west of the 0 meridian)
:<code><nowiki>df = ''</nowiki></code> – one of three keywords <code>dmy</code>, <code>mdy</code>, or <code>iso</code> used to specify date format typically used in the time zone; can be overridden with {{وسيط قالب|df}} template parameter
:<code><nowiki>dst_begins = ''</nowiki></code> – a four word sentence in the form <code><ordinal></code> <code><day name></code> <code><in|of></code> <code><month name></code> where:
::<code><ordinal></code> – any of the words 'first', '1st', 'second', '2nd',... 'fifth', '5th', or 'last'
::<code><day name></code> – any of the day names 'Sunday', 'Monday', 'Tuesday', etc.; capitalization is not important but otherwise must be spelled correctly; abbreviations not supported
::<code><in|of></code> – either of the words 'in' or 'of'
::<code><month name></code> – any of the month names 'January', 'February', 'March', etc.; capitalization is not important but otherwise must be spelled correctly; abbreviations not supported
:<code><nowiki>dst_ends = ''</nowiki></code> – (required if <code>dst_begins</code> is specified) same as <code>dst_begins</code>
:<code><nowiki>dst_time = ''</nowiki></code> – (required if <code>dst_begins</code> is specified) the time that daylight saving time begins; usually local time; when DST begins at a specified time UTC ([[European Summer Time]] for example) use: <code>dst_time = 'hh:mm UTC'</code>; four digits and the colon are required
:<code><nowiki>dst_e_time = ''</nowiki></code> – the time that daylight saving time ends if different from the time it begins; usually local daylight saving time ; when DST ends at a specified time UTC use: <code>dst_e_time = 'hh:mm UTC'</code>; four digits and the colon are required
:<code><nowiki>article = ''</nowiki></code> – (required) the title of a Wikipedia article that is appropriate to the timezone; do not include wikimarkup

The table-of-tables is organized east (plus UTC offsets) then west (minus UTC offset), by offset hours, and then alphabetically by time zone positional parameter name.
== طالع ايضا ==
* {{قا|تاريخ حالي}}
* {{قا|الآن}}
== مراجع ==
{{مراجع}}
<references group="upper-alpha"/>
<includeonly>{{#ifeq:{{SUBPAGENAME}}|ملعب| |
<!-- التصانيف هنا، ووصلات الانترويكي في ويكي بيانات -->
[[تصنيف:قوالب زمن وتاريخ وتقويم]]
[[تصنيف:قوالب زمنية]]
}}</includeonly>