https://wiki.sasgaming.net/index.php?action=history&feed=atom&title=Template%3AMC%2FTime_ago%2Fdoc
Template:MC/Time ago/doc - Revision history
2026-04-10T20:31:36Z
Revision history for this page on the wiki
MediaWiki 1.43.8
https://wiki.sasgaming.net/index.php?title=Template:MC/Time_ago/doc&diff=46877&oldid=prev
imported>Mitsos at 11:59, 18 January 2026
2026-01-18T11:59:01Z
<p></p>
<p><b>New page</b></p><div>{{documentation header}}<br />
<!-- Documentation here --><br />
{{lua}}<br />
Displays the relative time between a given date and the current time (e.g. "3 days ago", "2 months time").<br />
<br />
== Usage ==<br />
Displays the amount of time elapsed between a supplied date/time and the present moment in a human-readable format.<br />
<br />
=== Basic syntax ===<br />
<syntaxhighlight lang="wikitext"><br />
{{Time ago|date}}<br />
</syntaxhighlight><br />
<br />
=== Example ===<br />
<syntaxhighlight lang="wikitext"><br />
{{Time ago|2024-01-01}}<br />
</syntaxhighlight><br />
<br />
Produces:<br />
{{Time ago|2024-01-01}}<br />
<br />
== Parameters ==<br />
<br />
=== Required ===<br />
{| class="wikitable"<br />
! Parameter !! Description<br />
|-<br />
| <code>1</code> || Date or timestamp to compare with the current time. Must be parseable by MediaWiki.<br />
|}<br />
<br />
=== Optional ===<br />
<br />
==== <code>magnitude</code> ====<br />
Forces the output to use a specific unit instead of automatic selection.<br />
<br />
Valid values:<br />
* <code>seconds</code><br />
* <code>minutes</code><br />
* <code>hours</code><br />
* <code>days</code><br />
* <code>weeks</code><br />
* <code>months</code><br />
* <code>years</code><br />
<br />
<syntaxhighlight lang="wikitext"><br />
{{Time ago|2024-01-01|magnitude=days}}<br />
</syntaxhighlight><br />
<br />
Produces:<br />
{{Time ago|2024-01-01|magnitude=days}}<br />
<br />
==== <code>min_magnitude</code> ====<br />
Specifies the smallest unit of time that may be displayed.<br />
<br />
<syntaxhighlight lang="wikitext"><br />
{{Time ago|2024-01-01|min_magnitude=days}}<br />
</syntaxhighlight><br />
<br />
This prevents results such as "12 hours ago".<br />
<br />
==== <code>ago</code> ====<br />
Controls suffix text.<br />
<br />
{| class="wikitable"<br />
! Value !! Result<br />
|-<br />
| (default) || <code>3 days ago</code><br />
|-<br />
| <code>ago=</code> || <code>3 days</code><br />
|-<br />
| <code>ago=since</code> || <code>3 days since</code><br />
|}<br />
<br />
==== <code>spellout</code> ====<br />
Controls whether numbers are written as words.<br />
<br />
{| class="wikitable"<br />
! Value !! Behavior<br />
|-<br />
| <code>no</code> || Never spell numbers (default)<br />
|-<br />
| <code>auto</code> || Spell numbers from 1–9<br />
|-<br />
| <code>yes</code> || Spell numbers from 1–100<br />
|}<br />
<br />
<syntaxhighlight lang="wikitext"><br />
{{Time ago|yesterday|spellout=auto}}<br />
</syntaxhighlight><br />
<br />
Produces:<br />
{{Time ago|yesterday|spellout=auto}}<br />
<br />
==== <code>spelloutmax</code> ====<br />
Sets an upper limit for spelled-out numbers. <br />
<br />
<syntaxhighlight lang="wikitext"><br />
{{Time ago|2020-01-01|spellout=yes|spelloutmax=5}}<br />
</syntaxhighlight><br />
<br />
In this case, the date is {{Time ago|2020-01-01|spellout=yes|spelloutmax=5}}. Because the amount of years is larger than 5, it doesn't spell it out.<br />
<br />
==== <code>purge</code> ====<br />
Adds a purge link to the output to allow manual cache refresh.<br />
<br />
<syntaxhighlight lang="wikitext"><br />
{{Time ago|2024-01-01|purge=yes}}<br />
</syntaxhighlight><br />
<br />
Produces:<br />
{{Time ago|2024-01-01|purge=yes}}<br />
<br />
== Future dates ==<br />
Dates in the future are supported automatically.<br />
<br />
<syntaxhighlight lang="wikitext"><br />
{{Time ago|2030-01-01}}<br />
</syntaxhighlight><br />
<br />
Produces:<br />
{{Time ago|2030-01-01}}<br />
<br />
If <code>ago=</code> is empty:<br />
<br />
<syntaxhighlight lang="wikitext"><br />
{{Time ago|2030-01-01|ago=}}<br />
</syntaxhighlight><br />
<br />
Produces:<br />
{{Time ago|2030-01-01|ago=}}<br />
<br />
== Accepted date formats ==<br />
The first parameter accepts any date format supported by MediaWiki, including:<br />
* <code>YYYY-MM-DD</code><br />
* <code>YYYY-MM-DD HH:MM</code><br />
* <code>Month D, YYYY</code><br />
* <code>yesterday</code>, <code>today</code>, <code>now</code><br />
<br />
== Error handling ==<br />
If the date cannot be parsed, the template displays:<br />
<br />
<pre><br />
Error: first parameter cannot be parsed as a date or time.<br />
</pre><br />
<br />
== Unit selection ==<br />
The template automatically selects a unit using the following thresholds:<br />
<br />
{| class="wikitable"<br />
! Minimum elapsed time !! Unit used<br />
|-<br />
| ≥ 2 years || Years<br />
|-<br />
| ≥ 2 months || Months<br />
|-<br />
| ≥ 2 days || Days<br />
|-<br />
| ≥ 2 hours || Hours<br />
|-<br />
| ≥ 2 minutes || Minutes<br />
|-<br />
| Otherwise || Seconds<br />
|}<br />
<br />
<includeonly><br />
<!-- Template categories/interwikis here --><br />
[[nl:Sjabloon:Tijd geleden]]<br />
[[ru:Шаблон:Времени назад]]<br />
[[th:แม่แบบ:Time ago]]<br />
</includeonly><br />
<noinclude><br />
<!-- Documentation categories/interwikis here --><br />
[[nl:Sjabloon:Tijd geleden/doc]]<br />
[[ru:Шаблон:Времени назад/док]]<br />
[[th:แม่แบบ:Time ago/doc]]<br />
</noinclude></div>
imported>Mitsos