Difference between revisions of "Template:CurrentTimeIn"

From blackwiki
Jump to navigation Jump to search
imported>Staka
(fix examples and template page)
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)
 
(2 intermediate revisions by 2 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 32: Line 32:
  
 
[[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: