Template:Time ago/doc

This is a documentation subpage for Template:Time ago.

It contains usage information, categories, and other content that is not part of the original template page.

Template:Time ago invokes function main in Module:Time ago using Lua.

This template is imported from Template:Time ago/doc on Wikipedia.

This template is imported from the English Wikipedia. Although the visual appearance might be different, the functionality is identical. Please refer to the Template:Time ago/doc page on Wikipedia for detailed documentation.

The Time ago template calculates the amount of time which has passed since a provided timestamp. The result is a string similar to one of the examples below. This template should not be used with "subst" unless you don't want the stamp to change as the user refreshes the page.

The result is rounded down. "Month" is defined as 31 days.

Usage

• {{Time ago|timestamp}}

The timestamp can be almost any solid, readable format but to avoid ambiguity mistakes, one of the styles below is preferred.

• magnitude parameter can be set to explicitly use certain unit. Allowed values are: seconds, minutes, hours, days, weeks, months and years.
• min_magnitude parameter can be set to use the specified unit or bigger units. Allowed values are: seconds, minutes, hours, days, months and years.
• ago parameter can be set to override the default usage of the text "ago".

Examples

• {{Time ago| -83 minutes}} → 83 minutes ago
• {{Time ago| -334 minutes}} → 5 hours ago
• {{Time ago|{{REVISIONTIMESTAMP}}}} → 9 months ago
• {{Time ago| Jan 21, 2001 3:45 PM}} → 23 years ago
• {{Time ago| Nov 6 2008}} → 16 years ago
• {{Time ago| Nov 6 2008|magnitude=weeks}} → 841 weeks ago
• {{Time ago| Nov 6 2008|min_magnitude=days}} → 16 years ago
• {{Time ago| Nov 6 2008|min_magnitude=years}} → 16 years ago
• {{Time ago| Nov 6 2008|ago=in the past}} → 16 years in the past
• {{Time ago| Nov 6 2008|purge=yes}} → 16 years ago (purge)
• {{Time ago| Nov 6 2008|purge=x}} → 16 years ago (purge)