Editing Template:Time Ago/doc

{{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.<br>
{{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'' &mdash; display up to years
** ''mth'' or ''month'' &mdash; display up to months
** ''w'' or ''week'' &mdash; display up to weeks
** ''d'' or ''day'' &mdash; display up to days
** ''h'' or ''hour'' &mdash; display up to hours
** ''min'' or ''minute'' &mdash; display up to minutes
** blank &mdash; displays up to seconds

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

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

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

;No Labels
{{T|Time Ago|2020-09-28|p2=hidelabel=1|_Y_=1}}<br>
{{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>
File Pages	==Summary====Licensing=={{Fairuse}}{{File\|}}
Dynamic Page List	¦²«»²{¦}²«»«/»«!----»
Array in DPL	¹^2{}^2^2{¹}^2
Parser Functions	{{#if:\|\|}} {{#if:<condition>\|<result if true>\|<result if false>}} {{#ifeq:\|\|\|}} {{#ifeq:<text1>\|<text2>\|<result if text1=text2>\|<result if text1≠text2>}} {{#expr:}} {{#expr:<mathematical expression>}} {{#switch:\|\|#default=}} {{#switch:<text1>\|<text2>=<result if text1=text2>\|<text3>=<result if text1=text3>\|#default=<result if no valid match>}} {{#replace:\|\|}} {{#replace:<text1>\|<plain text to find in text1>\|<plain text to insert in place of the text found>}} {{#titleparts:}} {{#replace:<page name>}} {{#tag:\|}} {{#tag:<name of html tag>\|<content inside html tag>}}
Markup	{{}}\|[][[]][[Category:]]#REDIRECT [[]] [[Category:Redirect Pages]]<code></code><includeonly></includeonly><noinclude></noinclude><nowiki></nowiki><!----><br>§
Notices	{{Stub\|}}{{Stub Dialogue}}{{Upcoming}}{{Under Construction}}{{Placeholder\|}}
Magic Words	{{!}}{{formatnum:}}{{lc:}}{{uc:}}{{PAGENAME}}{{FULLPAGENAME}}{{ROOTPAGENAME}}{{BASEPAGENAME}}{{SUBPAGENAME}}{{DISPLAYTITLE:\|noreplace}}__TOC____NOTOC____EXPECTUNUSEDCATEGORY____HIDDENCAT__
HTML Entities	— ,