Template:Time zone/utc offset/doc

From Wikipedia, the free encyclopedia
Jump to navigation Jump to search

This template maps time zones to the UTC offset of their standard time (non-DST), from tz database. The output is formatted in "+HH:mm" or "−HH:mm", in plain text.

{{Time zone/utc offset}} has one required positional parameter for timezone name from tz database. For example:

  • {{Time zone/utc offset|America/New_York}} → −05:00
  • {{Time zone/utc offset|Europe/Berlin}} → +01:00
  • {{Time zone/utc offset|Australia/Sydney}} → +10:00

For invalid timezone names:

  • {{Time zone/utc offset}} → Time zone (null) is not in {{Tz/utc offset}}.
  • {{Time zone/utc offset|}} → Time zone is not in {{Tz/utc offset}}.
  • {{Time zone/utc offset|No such TZ name}} → Time zone No such TZ name is not in {{Tz/utc offset}}.

TemplateData

[edit source]
This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Time zone/utc offset in articles based on its TemplateData.

TemplateData for Time zone/utc offset

Maps time zones to the UTC offset of their standard time (non-DST), from tz database.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Timezone name1

Time zone name as defined in the tz database

Example
Europe/London
Stringrequired

See also

[edit source]

tz database

[edit source]

Sub templates store data from the tz database and some related information. These examples are accurate as of version 2025c of the database.

Code example Produces Description
{{Time zone/version|IncludeLink}} [https://data.iana.org/time-zones/releases/tzdata2025c.tar.gz 2025c] Produces the version number of the tz database. Update this template when updating those below with data from a new release. Add a parameter (value doesn't matter) to include a link to the IANA FTP site.
{{Time zone/country code|Asia/Urumqi}} CN Maps TZ to country code from zone.tab
{{Time zone/iso 3166-1 link|Asia/Urumqi}} [[ISO 3166-1:CN|CN]] Maps TZ to linked country code from zone.tab
{{Time zone/coordinates|Asia/Urumqi}} +4348+08735 Maps TZ to coordinates in original format from zone.tab
{{Time zone/comments|Asia/Urumqi}} Xinjiang Time Maps TZ to comments from zone.tab
{{Time zone/rulefile|Asia/Urumqi}} asia Maps TZ to linked continent file that defines the zone (or link) and DST rules.
{{Time zone/utc offset|Europe/Amsterdam}} +01:00 Maps TZ to normal (non-DST) UTC offset
{{Time zone/utc offset link|Europe/Amsterdam}} [[UTC+01:00|+01:00]] Maps TZ to linked normal (non-DST) UTC offset
{{Time zone/utc zone|Europe/Amsterdam}} UTC+01:00 Maps TZ to normal (non-DST) UTC offset with prefix
{{Time zone/utc dst offset|Europe/Amsterdam}} +02:00 Maps TZ to DST UTC offset
{{Time zone/utc dst offset link|Europe/Amsterdam}} [[UTC+02:00|+02:00]] Maps TZ to linked DST UTC offset
{{Time zone/zone.tab cols wikitable|Antarctica/South_Pole}}
| [[ISO 3166-1:AQ|AQ]] ||  || [[Antarctica/South_Pole]] ||
Maps TZ to 4 elements as a wikitable row – country code, coordinates, zone name, and comments
{{Time zone/zone.tab cols linked|Antarctica/South_Pole}}
| [[ISO 3166-1:AQ|AQ]]
|  
| Antarctica/South_Pole 
|  
| [[UTC+12:00|+12:00]]
| [[UTC+13:00|+13:00]]
Similar to {{Time zone/zone.tab cols wikitable}}, but adds two more lines to the output, containing the linked normal (non-DST) and DST UTC offsets
{{Time zone/zone.tab cols unlinked|Antarctica/South_Pole}}
| AQ
|  
| Antarctica/South_Pole
|  
| +12:00
| +13:00
Same as {{Time zone/zone.tab cols unlinked}}, but with no links
{{Time zone/zone.tab cols wiki6|Antarctica/South_Pole}}
| [[ISO 3166-1:AQ|AQ]]
| 
| <div style="text-indent: -1.6em; margin-left: 1.6em;">Antarctica<wbr />/South_Pole</div>
| 
| data-sort-value="43200" | [[UTC+12:00|+12:00]]
| data-sort-value="46800" | [[UTC+13:00|+13:00]]
A possibly slower version of {{Time zone/zone.tab cols linked}}.

Note: neither {{Time zone/zone.tab cols wiki6}} nor {{Time zone/zone.tab cols linked}} can currently be used for the full table in List of tz database time zones because of performance limitations in processing such a long table. They can, however, be used for a small number of rows in individual area articles.