Wuffesan: Created page with "{{Documentation/Header}} {{Lua|Time Ago}} Get the time since or time until a date. ==Syntax== If the time is lower than the last date unit specified, the next valid date unit will be shown instead.
{{T|Time Ago|v1=date|v2=last=last date unit to display|v3=include=comma list of the date units to display|v4=hidelabel=show number only and hide label text}} * Date units accepted: ''y'' or ''year'' — display up to years ''mth'' or ''month'' — display..."

2025-06-10T21:38:30Z

Created page with "{{Documentation/Header}} {{Lua|Time Ago}} Get the time since or time until a date. ==Syntax== If the time is lower than the last date unit specified, the next valid date unit will be shown instead. {{T|Time Ago|v1=date|v2=last=last date unit to display|v3=include=comma list of the date units to display|v4=hidelabel=show number only and hide label text}} * Date units accepted: ** ''y'' or ''year'' — display up to years ** ''mth'' or ''month'' — display..."

New page

{{Documentation/Header}}
{{Lua|Time Ago}}
Get the time since or time until a date.

==Syntax==
If the time is lower than the last date unit specified, the next valid date unit will be shown instead. 
{{T|Time Ago|v1=date|v2=last=last date unit to display|v3=include=comma list of the date units to display|v4=hidelabel=show number only and hide label text}}
* Date units accepted:
** ''y'' or ''year'' — display up to years
** ''mth'' or ''month'' — display up to months
** ''w'' or ''week'' — display up to weeks
** ''d'' or ''day'' — display up to days
** ''h'' or ''hour'' — display up to hours
** ''min'' or ''minute'' — display up to minutes
** blank — displays up to seconds

* '''include''' — takes priority over '''last''', enter a comma list of valid date units to display
* '''last''' — defaults to blank.
* '''lowercase''' — lowercase output.

==Examples==
;Basic Function
{{T|Time Ago|2025-12-23|p2=last=w|_Y_=1}} 
{{T|Time Ago|2025-12-23|p2=last=y|_Y_=1}} 
{{T|Time Ago|2020-12-23|p2=last=d|_Y_=1}} 
{{T|Time Ago|2019-12-23|p2=last=month|_Y_=1}} 

;Pick and Choose units
{{T|Time Ago|2019-12-23|p2=include=y,mth,d|_Y_=1}} 
{{T|Time Ago|2019-12-23|p2=include=mth|_Y_=1}} 
{{T|Time Ago|2022-08-22|p2=include=y,mth,d|_Y_=1}} 

;No Labels
{{T|Time Ago|2020-09-28|p2=hidelabel=1|_Y_=1}} 
{{T|Time Ago|2020-09-28|p2=last=year|p3=hidelabel=1|_Y_=1}}

;Lowercase
{{T|Time Ago|2050-09-28|p2=last=y|p3=lowercase=1|_Y_=1}}

==Template Data==
<templatedata>
{
"params": {
"1": {
"label": "Date",
"description": "Datetime to display.",
"type": "date",
"required": true
},
"last": {
"label": "Last Unit",
"description": "Smallest unit of time to display down to.",
"example": "\"y\", \"mth\", \"w\", \"d\", \"h\", \"min\", \"\"",
"type": "string",
"suggested": true
},
"include": {
"label": "Units to Include",
"description": "Comma list of unit(s) of time to display.",
"example": "\"y, mth, h\", \"w, min\"",
"type": "string",
"suggested": true
},
"hidelabel": {
"label": "Hide Label",
"description": "Set to \"1\" to remove \"In\", \"ago\", and time unit text.",
"example": "1",
"type": "boolean"
},
"lowercase": {
"label": "Lowercase Output",
"description": "Set to \"1\" to have lowercase \"in\".",
"example": "1",
"type": "boolean"
}
},
"description": "Get the time since or time until a date.",
"paramOrder": [
"1",
"last",
"include",
"hidelabel",
"lowercase"
],
"format": "inline"
}
</templatedata>
<includeonly>
</includeonly>

Template:Time Ago/doc - Revision history