imported>DB1729: Category:Time zones templates

2025-06-17T22:13:14Z

Category:Time zones templates

New page

{{Documentation subpage}}
This template returns a UTC offset string suitable for use with the <syntaxhighlight lang="wikitext" inline="1">{{#time:}}</syntaxhighlight> parser function:
: <syntaxhighlight lang="wikitext" inline="1">{{UTC offset|MST}}</syntaxhighlight> → {{UTC offset|MST}}

== Usage ==
This template takes two parameters:
*<code><{{var|timezone code}}></code> – (required) the first positional parameter specifies the timezone for which the offset is desired
*{{para|dst}} – (optional) when set to <code>no</code>, suppresses daylight saving time adjustment

Valid <code><{{var|timezone code}}></code> values are the same as those supported by {{tlx|time}}.

Typical use of this template is with the <syntaxhighlight lang="wikitext" inline="1">{{#time:}}</syntaxhighlight> parser function:
: <syntaxhighlight lang="wikitext" inline="1">{{#time:H:i}}</syntaxhighlight> → {{#time:H:i}} – UTC time
: <syntaxhighlight lang="wikitext" inline="1">{{UTC offset|MST}}</syntaxhighlight> → {{UTC offset|MST}} – MST or MDT offset from UTC
: <syntaxhighlight lang="wikitext" inline="1">{{#time:H:i | {{UTC offset|MST}} }}</syntaxhighlight> → {{#time:H:i | {{UTC offset|MST}} }} – MST or MDT time

Use {{para|dst|no}} to get the UTC offset for areas that do not support daylight saving time but are located within timezones that do: [[Arizona]] (does not) is located within the [[Mountain Time Zone]] (does).

===Supported time zones===
{{#lst:Template:Time/doc|supported_time_zones}}

===Error messages===
This template can emit three error messages:
*{{color|#d33|unknown timezone <{{var|unknown timezone}}>}} – this message emitted when <{{var|unknown timezone}}> is not a timezone known to [[Module:Time]]. To resolve this error, use a known timezone specifier.
*{{color|#d33|missing required timezone}} – this template requires a timezone specifier. To resolve this error, provide a known timezone specifier.
*{{color|#d33|error calculating dst timestamps}} – this template automatically applies daylight saving adjustment for those timezones that support it. This error message indicates that the underlying data in [[Module:Time/data]] for the timezone is malformed. To resolve this error, the underlying data must be corrected. This may be accomplished by anyone with administrator or template editor permission. Post a message at [[Template talk:Time]].

<includeonly>{{Sandbox other||

[[Category:Time zones templates]]
}}</includeonly>

Template:UTC offset/doc - Revision history

imported>DB1729: Category:Time zones templates