Sjabloon:Time ago/doc

Uit informatiestandaarden
Naar navigatie springen Naar zoeken springen

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.

Note that due to Wikipedia's caching mechanisms, you may need to purge a page using this template to update the dynamic value. See the section Purge below.

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".

Purge

Add the parameter |purge=yes to add a purge link.

Examples

  • {{Time ago| -83 minutes}}ago
  • {{Time ago| -334 minutes}}ago
  • {{Time ago|{{REVISIONTIMESTAMP}}}}ago
  • {{Time ago| Jan 21, 2001 3:45 PM}}ago
  • {{Time ago| Nov 6 2008}}ago
  • {{Time ago| Nov 6 2008|magnitude=weeks}}ago
  • {{Time ago| Nov 6 2008|min_magnitude=days}}ago
  • {{Time ago| Nov 6 2008|min_magnitude=years}}ago
  • {{Time ago| Nov 6 2008|ago=in the past}}in the past
  • {{Time ago| Nov 6 2008|purge=yes}}ago (purge)
  • {{Time ago| 2008-11-06}}ago

TemplateData

<TemplateData> {

       "description": "This template calculates the amount of time which has passed since a provided timestamp.",
       "params": {
               "1": {
                       "label": "Timestamp",
                       "description": "Base timestamp for calculation of passed time. Example format: Nov 6 2008, see template documentation for other supported formats.",
                       "type": "string",
                       "required": true
               },
               "magnitude": {
                       "label": "magnitude",
                       "description": "Explicitly sets a specific unit to display return value. Allowed values are: seconds, minutes, hours, days, weeks, months and years.",
                       "type": "string",
                       "required": false
               },
               "min_magnitude": {
                       "label": "min_magnitude",
                       "description": "Sets a minimum unit to display return value. Allowed values are: seconds, minutes, hours, days, months and years.",
                       "type": "string",
                       "required": false
               },
               "ago": {
                       "label": "ago",
                       "description": "Parameter can be set to override the default usage of the text 'ago'.",
                       "type": "string",
                       "required": false
               },
               "purge": {
                       "label": "Purge link",
                       "description": "Add the parameter purge=yes to add a WP:PURGE link.",
                       "type": "string",
                       "required": false
               }
       }

} </TemplateData>


See also