Module:Duration/doc
This is the documentation page for Module:Duration
This module is rated as beta, and is ready for widespread use. It is still new and should be used with some caution to ensure the results are as expected. |
This Lua module is used on many pages and changes may be widely noticed. Test changes in the module's /sandbox or /testcases subpages, or in your own module sandbox. Consider discussing changes on the talk page before implementing them. |
This module implements {{Duration}}. It tries to add a microformat to a duration (hh:mm:ss
or mm:ss
) whenever possible. If the module is unable to add hAudio microformat (and the input does not contain the microformat) then the page will be included in Category:Duration without hAudio microformat (0).
Usage
This template should normally be called through {{Duration}}, and used as {{#invoke:Duration|main|duration=duration}}
when included in other templates.
Valid parameters are numbered parameters 1, 2 and 3, and unnumbered parameters |h=
, |m=
, |s=
and |duration=
. |duration=
should not be used in {{Duration}}, as |1=
can provide the same function.
The two triplets of parameters accept numbers as inputs (hours, minutes, seconds respectively). Only |3=
and |s=
can contain decimals; the others must be integers. The seconds value must not exceed 60, and the minutes value must not exceed 60 if there is an hours value. If the inputs are not recognized as numbers, an error message is returned.
|1=
and |duration=
accept strings. If the string contains a microformat then the string will be returned without modification. Otherwise, the module will attempt to add an hAudio microformat to the first unformatted duration found. If the string contains more than one duration, only the first one will have a microformat added.
Errors are placed in Category:Duration with input error (0).