Template:Duration

Template documentation[view] [edit] [history] [purge]

This template is used on approximately 43,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This template uses Lua:

Module:Duration (sandbox)

This template emits the hAudio microformat.

Usage

Unformatted input

An unformatted duration can be input in the first parameter: {{Duration|10:20:30}} (hours:minutes:seconds) or {{Duration|20:30}} (minutes:seconds). There must be a seconds value, as inputs in hours and minutes are indistinguishable from inputs in minutes and seconds.

Numbered parameters

{{Duration|10|20|30}}

where parameters are hours, minutes and seconds respectively. If the hours or minutes values are zero, then leave them blank (e.g. {{Duration||20|30}}). Minutes and seconds values default to zero, although they should ideally be specified.

h, m and s parameters

{{Duration|h=10|m=20|s=30}}

where h, m and s are hours, minutes and seconds respectively. Minutes and seconds values default to zero, although they should ideally be specified.

Parent templates

This template can be used in:

{{Infobox album}}
{{Infobox song}}

In {{Infobox album}}, the microformat is added automatically if there is not one already. However, more complicated values might require this template.

Examples

Unformatted input

{{Duration|1:22:34}} renders as: 1:22:34
{{Duration|74:32}} renders as: 74:32
{{Duration|1:02:34}} renders as: 1:02:34
{{Duration|1:2:3}} renders as: 1:02:03
{{Duration|0:22:34}} renders as: 0:22:34
{{Duration|0:0:34}} renders as: 0:00:34
{{Duration|0:34}} renders as: 0:34

h, m and s parameters

{{Duration|h=1|m=22|s=34}} renders as: 1:22:34
{{Duration|m=74|s=32}} renders as: 74:32
{{Duration|m=2|s=34}} renders as: 2:34
{{Duration|h=1|s=34}} renders as: 1:00:34
{{Duration|h=1}} renders as: 1:00:00
{{Duration|h=0|m=22|s=34}} renders as: 0:22:34
{{Duration|h=0|m=0|s=34}} renders as: 0:00:34
{{Duration|h=1|m=22|s=34.5678}} renders as: 1:22:34.5678
{{Duration|h=1|m=22|s=3}} renders as: 1:22:03
{{Duration|h=1|m=2|s=34}} renders as: 1:02:34
{{Duration|h=1|m=2|s=3}} renders as: 1:02:03
{{Duration|h=1|m=2}} renders as: 1:02:00
{{Duration|s=34}} renders as: 0:34
{{Duration|m=0|s=34}} renders as: 0:34
{{Duration|h=1|m=0|s=34}} renders as: 1:00:34
{{Duration|h=1|m=22|s=0}} renders as: 1:22:00
N {{Duration|h=one|m=22|s=0}} renders as: Error in Module:Duration: Invalid values
N {{Duration|h=1|m=22|s=78}} renders as: Error in Module:Duration: Seconds value must be less than 60
N {{Duration|h=1.1|m=2.2}} renders as: Error in Module:Duration: Hours and minutes values must be integers

Numbered parameters

{{Duration|1|22|34}} renders as: 1:22:34
{{Duration||74|32}} renders as: 74:32
{{Duration|1|2|34}} renders as: 1:02:34
{{Duration|1|2|3}} renders as: 1:02:03
{{Duration|0|22|34}} renders as: 0:22:34
{{Duration|0|0|34}} renders as: 0:00:34
{{Duration||0|34}} renders as: 0:34
{{Duration|||34}} renders as: 0:34
{{Duration|1|22|34.5678}} renders as: 1:22:34.5678
{{Duration||1|22}} renders as: 1:22
{{Duration|1|22}} renders as: 1:22:00
{{Duration|1|22|0}} renders as: 1:22:00
N {{Duration|1|22|}} renders as: 1:22:00
{{Duration|0|0|0}} renders as: (blank)
{{Duration|||}} renders as: (blank)
N {{Duration|1|22|34|55}} renders as: Error in Module:Duration: Parameter number 4 should not be specified
N {{Duration|one|22|0}} renders as: Error in Module:Duration: Invalid values
N {{Duration|1|22|78}} renders as: Error in Module:Duration: Seconds value must be less than 60
N {{Duration|1.1|2.2}} renders as: Error in Module:Duration: Hours and minutes values must be integers

Microformat

The HTML mark-up produced by this template includes HTML classes intended to be part of an hAudio microformat that makes an audio recording's details readily parsable by computer programs. This aids tasks such as the cataloguing of articles and maintenance of databases. For more information about the use of microformats on Wikipedia, please visit the Microformat WikiProject.

Classes used

The HTML classes of this microformat include:

fn
album
description
category
contributor
duration
h
item
min
photo
position
price
published
s

Please do not rename or remove these classes
nor collapse nested elements which use them.

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Duration in articles based on its TemplateData.

TemplateData for Duration

For use in templates emitting the hAudio [[microformat]]

Template parameters[Edit template data]
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Hours	`h` `1`	no description Example 3	Number	suggested
Minutes	`m` `2`	no description Example 32	Number	suggested
Seconds	`s` `3`	no description Example 42	Number	suggested

The above documentation is transcluded from Template:Duration/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.