![]() | This template is used on approximately 31,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: |
This template takes a duration as input, and converts it to a duration with units such that the value will be relatively small for readability. For example, 3600 seconds will be converted to 1 hour. This conversion will result in loss of precision in nearly all cases, and is meant only for situations where the exact value is unimportant: for example, 123456789 seconds is approx. 3,915 years but will be converted to 4 years.
Usage
{{human readable duration|duration|unit}}
Parameters
This template requires two positional parameters:
|1=
The amount of time to convert from, expressed in the unit given.
|2=
The unit which the duration is expressed in. Must be one of second
, minute
, hour
, day
, month
, or year
, optionally pluralized.
Examples
{{human readable duration|10|seconds}}
→ 10 seconds{{human readable duration|0.0027|hours}}
→ 9.5 seconds{{human readable duration|1000|minutes}}
→ 16.5 hours{{human readable duration|24|hours}}
→ 1 day{{human readable duration|50|hours}}
→ 50 hours{{human readable duration|100|hours}}
→ 4 days{{human readable duration|66|months}}
→ 5.5 years
Function
For the purposes of this template "relatively small values" include up to 60 seconds, 60 minutes, 72 hours, 50 days, 18 months, and years rounded to half a year above that. So a value of 1000 minutes is presented as 16.5 hours because 1000 is "too large" a number to present in the unit given. In the next bigger unit (hours), however, 1000 minutes is expressed using a number less than 72, so that's what we end up with.