View source for Template:Countdown/doc

{{Documentation/Header}}
{{See also|Template:Countdownall}}
(Countdown) - Parses EventName, TimeStart and TimeEnd into a countdown, mostly used on event mentioning pages.

*This template works with a JavaScript snippet imported from the [https://dev.fandom.com/wiki/Countdown developer's wiki] into this wiki's [[MediaWiki:ImportJS]]. It does NOT use the countdown extension.
*Utilizes the [[mw:Help:Extension:ParserFunctions|parser functions]] {{F|<nowiki>{{#time:F d, Y h:i:s A e|}}</nowiki>}} and {{F|<nowiki>{{#time:F d, Y|}}</nowiki>}} and is thus able to accept a variety of formats which are parsed and stored internally as UTC.
*The following are accepted: backslashes (2019/1/1), dashes (2019-1-1), most manner of timezones (+9, +9 hours. +0930, JST, GMT +9) and commas in the correct spacing (November 20th, 2019).
*The following are not accepted and will throw errors: any dots as they cause non integer values, including dot spacing (2019.1.1) and specifying timezones in non integer (+9.5).
*If no timezone is specified e.g. October 04, 2018 06:00, the syntax automatically assumes UTC.

==Examples==
;Case{{colon}} Offset
{{T|Countdown
|p1=Region=AS
|p2=EventName=Offset1
|p3=TimeStart=2024/01/15 23:00:00
|p4=TimeStartOffset=GMT+8
|p5=TimeEnd=2035/01/31 03:59:59
|p6=TimeEndOffset=GMT+8
|block=1|_Ybr_=1}}
;Case{{colon}} Upcoming
{{T|Countdown
|p1=Region=AS
|p2=EventName=TemplateExample1
|p3=TimeStart=2035/01/15 23:00:00 GMT+8
|p4=TimeEnd=2035/01/31 03:59:59 GMT+8
|block=1|_Ybr_=1}}
;Case{{colon}} Started
{{T|Countdown
|p1=Region=AS
|p2=EventName=TemplateExample2
|p3=TimeStart=2021-01-8 10:00:00 GMT+8
|p4=TimeEnd=2035-01-31 03:59:59 GMT+8
|block=1|_Ybr_=1}}
;Case{{colon}} Long Ended
{{T|Countdown
|p1=Region=AS
|p2=EventName=TemplateExample3
|p3=TimeStart=2020-01-16 10:00:00 GMT+8
|p4=TimeEnd=2020-01-31 03:59:59 GMT+8
|block=1|_Ybr_=1}}
;Case{{colon}} Blank Start
{{T|Countdown
|p1=Region=AS
|p2=EventName=TemplateExample4
|p3=TimeStart=
|p4=TimeEnd=2035-01-31 03:59:59 GMT+8
|block=1|_Ybr_=1}}
;Case{{colon}} Blank Start Ended
{{T|Countdown
|p1=Region=AS
|p2=EventName=TemplateExample4
|p3=TimeStart=
|p4=TimeEnd=2020-01-31 03:59:59 GMT+8
|block=1|_Ybr_=1}}
;Case{{colon}} Blank End
{{T|Countdown
|p1=Region=AS
|p2=EventName=TemplateExample5
|p3=TimeStart=2035-01-31 03:59:59 GMT+8
|p4=TimeEnd=
|block=1|_Ybr_=1}}
;Case{{colon}} Blank End Started
{{T|Countdown
|p1=Region=AS
|p2=EventName=TemplateExample5
|p3=TimeStart=2020-01-31 03:59:59 GMT+8
|p4=TimeEnd=
|block=1|_Ybr_=1}}
;Case{{colon}} Invalid Start
{{T|Countdown
|Region=AS
|EventName=TemplateExample6
|TimeStart=aaaaaaaaaaaa
|TimeEnd=2035/01/31 03:59:59 GMT+8
|block=1|_Ybr_=1}}
;Case{{colon}} Invalid End
{{T|Countdown
|p1=Region=AS
|p2=EventName=TemplateExample7
|p3=TimeStart=2035/01/16 10:00:00 GMT+8
|p4=TimeEnd=aaaaaaaaaaaa
|block=1|_Ybr_=1}}
;Case{{colon}} Invalid Start End
{{T|Countdown
|p1=Region=AS
|p2=EventName=TemplateExample8
|p3=TimeStart=aaaaaaaaaaaa
|p4=TimeEnd=aaaaaaaaaaaa
|block=1|_Ybr_=1}}
;Case{{colon}} Blank
{{T|Countdown
|p1=Region=AS
|p2=EventName=TemplateExample9
|p3=TimeStart=
|p4=TimeEnd=
|block=1|_Ybr_=1}}
{{clr}}
==Template Data==
<templatedata>
{
	"params": {
		"Region": {
			"description": "The region the countdown is for",
			"example": "NA",
			"suggested": true
		},
		"TimeStartOffset": {
			"label": "Start Offset",
			"description": "The offset for the start time",
			"example": "UTC+8",
			"suggested": true
		},
		"TimeEndOffset": {
			"label": "End Offset",
			"description": "The offset for the end time",
			"example": "UTC+8",
			"suggested": true
		},
		"TimeStart": {
			"label": "Start Time",
			"description": "The time the event starts, formatted as a date",
			"example": "1970-01-01 00:00:00",
			"suggested": true
		},
		"TimeEnd": {
			"label": "End Time",
			"description": "The time the event ends, formatted as a date",
			"example": "1970-01-02 00:00:00",
			"required": true
		},
		"HideText": {
			"label": "Hide Text",
			"description": "Whether to hide the \"ends in\" text",
			"suggested": true
		},
		"EndText": {
			"label": "End Text",
			"description": "The text to display when the event ends",
			"suggested": true
		},
		"CountdownPrefix": {
			"label": "Countdown Prefix",
			"description": "The prefix to use for the end countdown instead of \"Ends in:\"",
			"suggested": true
		}
	},
	"description": "Template for displaying a countdown",
	"paramOrder": [
		"Region",
		"TimeStartOffset",
		"TimeEndOffset",
		"TimeStart",
		"TimeEnd",
		"HideText",
		"EndText",
		"CountdownPrefix"
	]
}
</templatedata>