Difference between revisions of "Template:CurrentTimeIn"

From blackwiki
Jump to navigation Jump to search
imported>Cydebot
m (Robot - Moving category Date math to Date mathematics templates per CFD at Wikipedia:Categories for discussion/Log/2007 January 19.)
imported>Zyxw
m (Since <tt> is obsolete in HTML5, replace it with <kbd> – see HTML element#tt, Wikipedia:HTML5, and mw:Help:Extension:Linter/obsolete-tag. using AWB)
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<includeonly>[[List of time zones|{{utc|{{#expr:({{{UsualDifferenceFromUTCForThisLocation|0}}})+({{{DSTAdjustment|0}}})}}}}]]</includeonly><noinclude>{{
+
<includeonly>[[Lists of time zones|{{utc|{{#expr:({{{UsualDifferenceFromUTCForThisLocation|0}}})+({{{DSTAdjustment|0}}})}}}}]]</includeonly><noinclude>
 
 
 
This template prints the current UTC time offset by (UsualDifferenceFromUTCForThisLocation + DSTAdjustment) hours.
 
This template prints the current UTC time offset by (UsualDifferenceFromUTCForThisLocation + DSTAdjustment) hours.
  
 
; Syntax<nowiki>:</nowiki>
 
; Syntax<nowiki>:</nowiki>
: <tt><nowiki>{{</nowiki>{{PAGENAME}} ''<nowiki>[</nowiki>'' <nowiki>|</nowiki></tt>
+
: <kbd><nowiki>{{</nowiki>{{PAGENAME}} ''<nowiki>[</nowiki>'' <nowiki>|</nowiki></kbd>
:: <tt>''<nowiki>[</nowiki>'' UsualDifferenceFromUTCForThisLocation=''hours''<nowiki>|</nowiki> ''<nowiki>]</nowiki>''</tt>
+
:: <kbd>''<nowiki>[</nowiki>'' UsualDifferenceFromUTCForThisLocation=''hours''<nowiki>|</nowiki> ''<nowiki>]</nowiki>''</kbd>
:: <tt>''<nowiki>[</nowiki>'' DSTAdjustment=''hours''<nowiki>|</nowiki> ''<nowiki>]</nowiki>''</tt>
+
:: <kbd>''<nowiki>[</nowiki>'' DSTAdjustment=''hours''<nowiki>|</nowiki> ''<nowiki>]</nowiki>''</kbd>
: <tt>''<nowiki>]</nowiki>'' <nowiki>}}</nowiki></tt>
+
: <kbd>''<nowiki>]</nowiki>'' <nowiki>}}</nowiki></kbd>
 
Missing parameters (or completely empty parameters, without even any blank in the ''hours'' value) are treated like zero.
 
Missing parameters (or completely empty parameters, without even any blank in the ''hours'' value) are treated like zero.
  
Line 20: Line 19:
 
<pre>The current time in London is {{CurrentTimeIn|
 
<pre>The current time in London is {{CurrentTimeIn|
 
   UsualDifferenceFromUTCForThisLocation=0|
 
   UsualDifferenceFromUTCForThisLocation=0|
   DSTAdjustment={{Current daylight saving offset in Europe}}</pre>
+
   DSTAdjustment={{Current daylight saving offset in Europe}}}}</pre>
 
and
 
and
 
<pre>The current time in Paris is {{CurrentTimeIn|
 
<pre>The current time in Paris is {{CurrentTimeIn|
 
   UsualDifferenceFromUTCForThisLocation=1|
 
   UsualDifferenceFromUTCForThisLocation=1|
   DSTAdjustment={{Current daylight saving offset in Europe}}</pre>
+
   DSTAdjustment={{Current daylight saving offset in Europe}}}}</pre>
 
and when the clocks change in Europe, the only page we have to change is {{tl|Current daylight saving offset in Europe}} which is minimal number of pages.
 
and when the clocks change in Europe, the only page we have to change is {{tl|Current daylight saving offset in Europe}} which is minimal number of pages.
  
Line 32: Line 31:
 
* [[Template:Utc]]
 
* [[Template:Utc]]
  
Template documentation}}[[Category:Date mathematics templates|{{PAGENAME}}]]
+
[[Category:Date mathematics templates|{{PAGENAME}}]]
[[Category:Templates using ParserFunctions|{{PAGENAME}}]]
+
 
  
 
</noinclude>
 
</noinclude>

Latest revision as of 06:55, 5 August 2018

This template prints the current UTC time offset by (UsualDifferenceFromUTCForThisLocation + DSTAdjustment) hours.

Syntax:
{{CurrentTimeIn [ |
[ UsualDifferenceFromUTCForThisLocation=hours| ]
[ DSTAdjustment=hours| ]
] }}

Missing parameters (or completely empty parameters, without even any blank in the hours value) are treated like zero.

Rationale:

The reason we separate out the "usual" difference from UTC and the DST adjustment is that the first part remains constant forever.

Whereas the second part changes twice a year.

This arrangement is the best way to minimize the number of pages we have to change when the clock changes.

Examples:
The current time in London is {{CurrentTimeIn|
  UsualDifferenceFromUTCForThisLocation=0|
  DSTAdjustment={{Current daylight saving offset in Europe}}}}

and

The current time in Paris is {{CurrentTimeIn|
  UsualDifferenceFromUTCForThisLocation=1|
  DSTAdjustment={{Current daylight saving offset in Europe}}}}

and when the clocks change in Europe, the only page we have to change is {{Current daylight saving offset in Europe}} which is minimal number of pages.

This template is usually wrapped by another template which controls the positioning of the time on the page. One example is {{CurrentTimeInHeader}} which puts the time near the top of the page.

See also: