Template:Time ago - The Furrydelphia Wiki

0 seconds ago

File:Test Template Info-Icon - Version (2).svg Template documentationview edit history purge

{{#ifeq:time ago |doc

{{#ifeq:show |show

This is a documentation subpage for Template:Time ago{{#if:||.}}
It may contain usage information, categories and other content that is not part of the original {{#if: |{{{text2}}} |{{#if: |{{{text1}}} |{{#ifeq:Template |User |template template page |{{#if:Template |template page|article}}}}}}}}.

        }}{{#if:|
         |{{#ifexist:Template:Time ago
                  | [[Category:{{#switch:Template |Template=Template |Module=Module |User=User |#default=Wikipedia}} documentation pages]]
                  | 
                 }}
        }}
    | 
   }}

Warning

This template is used on approximately 187,000 pages.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

File:Lua-Logo.svg

This template uses Lua:

Module:Time ago

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

[edit source]

{{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". If the parameter is blank but not missing (i.e. {{time ago|2008|ago=}}), then the text "ago" is suppressed altogether. For future dates, setting "ago" as blank but not missing will suppress the text "time" (i.e. "2 years" instead of "2 years' time").

Spelling out numbers

[edit source]

Numbers from 1 to 100 can be spelled out in their equivalent English word by using the spellout parameter. If spellout is set to "yes", "y", "true" or "1", all numbers from 1 to 100 will be spelled out. If spellout is set to "auto", only numbers from 1 to 9 will be spelled out, as per the recommendations at MOS:NUMERAL.

It is also possible to set a custom maximum value for spelling out by using the spelloutmax parameter. For example, setting |{{SAFESUBST:#if:spellout|spellout=}}yes and |{{SAFESUBST:#if:spelloutmax|spelloutmax=}}24 will result in all numbers less than or equal to 24 being spelled out, and all numbers greater than 24 appearing as numerals.

Numeric output

[edit source]

Add |{{SAFESUBST:#if:numeric|numeric=}}y to print the number only (no text).

Purge link

[edit source]

Add the parameter |{{SAFESUBST:#if:purge|purge=}}yes to add a purge link.

Examples

[edit source]

{{Time ago|-83 minutes}} → 83 minutes ago
{{Time ago|-334 minutes}} → 5 hours ago
{{Time ago|+334 minutes}} → 5 hours' time
{{Time ago|-334 minutes|ago=}} → 5 hours
{{Time ago|1901}} → 125 years ago
{{Time ago|{{REVISIONTIMESTAMP}}}} → 8 months ago
{{Time ago|Jan 21, 2001 3:45 PM}} → 25 years ago
Wrong: {{Time ago|3:45 pm, 21 Jan 2001}} → Error: first parameter cannot be parsed as a date or time.
{{Time ago|20010121154500}} → 25 years ago
{{Time ago|Nov 6 2008}} → 17 years ago
{{Time ago|Nov 6 2008|magnitude=weeks}} → 927 weeks ago
{{Time ago|Nov 6 2008|min_magnitude=days}} → 17 years ago
{{Time ago|Nov 6 2008|min_magnitude=years}} → 17 years ago
{{Time ago|Nov 6 2008|ago=in the past}} → 17 years in the past
{{Time ago|Nov 6 2008|purge=yes}} → 17 years ago (purge)
{{Time ago|2008-11-06}} → 17 years ago
{{Time ago| June 1, 2009|spellout=yes}} → seventeen years ago
{{Time ago| June 1, 1999|spellout=yes}} → twenty-seven years ago
{{Time ago| June 1, 2009|spellout=auto}} → 17 years ago
{{Time ago| June 1, 1999|spellout=auto}} → 27 years ago
{{Time ago| June 1, 1989|spellout=yes|spelloutmax=15}} → 37 years ago
{{Time ago| June 1, 1989|spellout=yes|spelloutmax=25}} → 37 years ago
{{Time ago|195909}} → 5 hours' time
Wrong: {{Time ago|196009}} → Error: first parameter cannot be parsed as a date or time.

TemplateData

[edit source]

{{#if:|{{#switch:

|=[https://bambots.brucemyers.com/TemplateParam.php?wiki=enwiki&template=%7B%7B%23if%3ATime+ago%7CTime+ago%7CTime+ago%7D%7D {{#ifeq:{{safesubst:#switch: {{{lc}}}
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|no|S|s}}ee a monthly parameter usage report] for {{#if:Time ago|Template:Time ago|this template}} in articles{{#ifeq:{{safesubst:#switch: y

|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Time ago|its|this}} TemplateData}}.

|None|none=[https://bambots.brucemyers.com/TemplateParam.php?wiki=enwiki&template=%7B%7B%23if%3ATime+ago%7CTime+ago%7CTime+ago%7D%7D {{#ifeq:{{safesubst:#switch: {{{lc}}}
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|no|P|p}}arameter usage report]{{#ifeq:{{safesubst:#switch: y

|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Time ago|its|this}} TemplateData}}

|for|For=[https://bambots.brucemyers.com/TemplateParam.php?wiki=enwiki&template=%7B%7B%23if%3ATime+ago%7CTime+ago%7CTime+ago%7D%7D {{#ifeq:{{safesubst:#switch: {{{lc}}}
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|no|P|p}}arameter usage report] for {{#if:Time ago|Template:Time ago|Template:Time ago}}{{#ifeq:{{safesubst:#switch: y

|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Time ago|its|this}} TemplateData}}.

|#default=[1]{{#ifeq:{{safesubst:#switch: y
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Time ago|its|this}} TemplateData}} }}|This is the {{#if:|TemplateData|TemplateData}} for this template used by TemplateWizard, VisualEditor and other tools. {{#switch:

|=[https://bambots.brucemyers.com/TemplateParam.php?wiki=enwiki&template=%7B%7B%23if%3ATime+ago%7CTime+ago%7CTime+ago%7D%7D {{#ifeq:{{safesubst:#switch: {{{lc}}}
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|no|S|s}}ee a monthly parameter usage report] for {{#if:Time ago|Template:Time ago|this template}} in articles{{#ifeq:{{safesubst:#switch: y

|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Time ago|its|this}} TemplateData}}.

|None|none=[https://bambots.brucemyers.com/TemplateParam.php?wiki=enwiki&template=%7B%7B%23if%3ATime+ago%7CTime+ago%7CTime+ago%7D%7D {{#ifeq:{{safesubst:#switch: {{{lc}}}
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|no|P|p}}arameter usage report]{{#ifeq:{{safesubst:#switch: y

|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Time ago|its|this}} TemplateData}}

|for|For=[https://bambots.brucemyers.com/TemplateParam.php?wiki=enwiki&template=%7B%7B%23if%3ATime+ago%7CTime+ago%7CTime+ago%7D%7D {{#ifeq:{{safesubst:#switch: {{{lc}}}
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|no|P|p}}arameter usage report] for {{#if:Time ago|Template:Time ago|Template:Time ago}}{{#ifeq:{{safesubst:#switch: y

|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Time ago|its|this}} TemplateData}}.

|#default=[2]{{#ifeq:{{safesubst:#switch: y
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Time ago|its|this}} TemplateData}} }}}}

TemplateData for Time ago

{{#switch:

 {{#if:
 | {{{demospace}}}    
 | {{#ifeq:Template|Template
   | template
   | other
   }}
 }}

| template = {{safesubst:#if:{{safesubst:#ifeq:Time ag|sandbox|1}}{{safesubst:#ifeq:Time ago|doc|1}}||

}} | other | #default = }} <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": "Override the default usage of the text 'ago'. If it is blank but not missing then 'ago' will be removed completely; for future dates, this will remove the text 'time' as well.", "type": "string", "required": false }, "purge": { "label": "Purge link", "description": "Add the parameter purge=yes to add a WP:PURGE link.", "type": "string", "required": false }, "spellout": { "type": "string/line", "label": "Spell out numbers", "description": "If set to \"yes\", \"y\", \"true\" or \"1\", numbers from 1 to 100 are spelled out as English words. If set to \"auto\", numbers from 1 to 9 are spelled out." }, "spelloutmax": { "type": "number", "label": "Spell out max", "description": "The maximum number to be spelled out as an English word." } } } </templatedata>

Usage

Spelling out numbers

Numeric output

Purge link

Examples

TemplateData

See also