Template:Countdown: Difference between revisions

Browse history interactively

← Older edit Newer edit →

VisualWikitext

Revision as of 00:07, 19 September 2026

Template documentation

[view] [edit] [history] [purge]

Note: parts of or the entire template might not be visible without values provided.

Main

Documentation

Usage

This template uses JS found at MediaWiki:Gadget-Countdown.js.

See also: Template:Countdownall

Parameters

Template for displaying a countdown

Template parameters[Edit template data]
Parameter		Description	Type	Status
Region	`Region`	The region the countdown is for Example NA	Unknown	suggested
Start Offset	`TimeStartOffset`	The offset for the start time Example UTC+8	Unknown	suggested
End Offset	`TimeEndOffset`	The offset for the end time Example UTC+8	Unknown	suggested
Start Time	`TimeStart`	The time the event starts, formatted as a date Example 1970-01-01 00:00:00	Unknown	suggested
End Time	`TimeEnd`	The time the event ends, formatted as a date Example 1970-01-02 00:00:00	Unknown	required
Hide Text	`HideText`	Whether to hide the "ends in" text	Unknown	suggested
End Text	`EndText`	The text to display when the event ends	Unknown	suggested
Countdown Prefix	`CountdownPrefix`	The prefix to use for the end countdown instead of "Ends in:"	Unknown	suggested

Examples

Case: Offset

{{Countdown
|Region=AS
|EventName=Offset1
|TimeStart=2024/01/15 23:00:00
|TimeStartOffset=GMT+8
|TimeEnd=2050/01/31 03:59:59
|TimeEndOffset=GMT+8
}}

{{#if:2024/01/15 23:00:002050/01/31 03:59:59|{{#iferror:||{{#ifexpr:1793109643<1705330800|(AS) Starts in: (Update)

Case: Upcoming

{{Countdown
|Region=AS
|EventName=TemplateExample1
|TimeStart=2050/01/15 23:00:00 GMT+8
|TimeEnd=2025/01/31 03:59:59 GMT+8
}}

{{#if:2050/01/15 23:00:00 GMT+82025/01/31 03:59:59 GMT+8|{{#iferror:||{{#ifexpr:1793109643<2525871600|(AS) Starts in: 8481d 0h 59m 17s (Update)

Case: Started

{{Countdown
|Region=AS
|EventName=TemplateExample2
|TimeStart=2021-01-8 10:00:00 GMT+8
|TimeEnd=2050-01-31 03:59:59 GMT+8
}}

{{#if:2021-01-8 10:00:00 GMT+82050-01-31 03:59:59 GMT+8|{{#iferror:||{{#ifexpr:1793109643<1610071200|(AS) Starts in: (Update)

Case: Long Ended

{{Countdown
|Region=AS
|EventName=TemplateExample3
|TimeStart=2020-01-16 10:00:00 GMT+8
|TimeEnd=2020-01-31 03:59:59 GMT+8
}}

{{#if:2020-01-16 10:00:00 GMT+82020-01-31 03:59:59 GMT+8|{{#iferror:||{{#ifexpr:1793109643<1579140000|(AS) Starts in: (Update)

Case: Blank Start

{{Countdown
|Region=AS
|EventName=TemplateExample4
|TimeStart=
|TimeEnd=2025-01-31 03:59:59 GMT+8
}}

{{#if:2050-01-31 03:59:59 GMT+8|{{#iferror:||{{#ifexpr:1793109643<1793109643|(AS) Starts in: (Update)

Case: Blank Start Ended

{{Countdown
|Region=AS
|EventName=TemplateExample4
|TimeStart=
|TimeEnd=2020-01-31 03:59:59 GMT+8
}}

{{#if:2020-01-31 03:59:59 GMT+8|{{#iferror:||{{#ifexpr:1793109643<1793109643|(AS) Starts in: (Update)

Case: Blank End

{{Countdown
|Region=AS
|EventName=TemplateExample5
|TimeStart=2025-01-31 03:59:59 GMT+8
|TimeEnd=
}}

{{#if:2050-01-31 03:59:59 GMT+8|{{#iferror:||{{#ifexpr:1793109643<2527185599|(AS) Starts in: 8496d 5h 59m 16s (Update)

Case: Blank End Started

{{Countdown
|Region=AS
|EventName=TemplateExample5
|TimeStart=2020-01-31 03:59:59 GMT+8
|TimeEnd=
}}

{{#if:2020-01-31 03:59:59 GMT+8|{{#iferror:||{{#ifexpr:1793109643<1580414399|(AS) Starts in: (Update)

Case: Invalid Start

{{Countdown
|Region=AS
|EventName=TemplateExample6
|TimeStart=aaaaaaaaaaaa
|TimeEnd=2050/01/31 03:59:59 GMT+8
}}

{{#if:aaaaaaaaaaaa2050/01/31 03:59:59 GMT+8|{{#iferror:Expression error: Unexpected < operator.||{{#ifexpr:1793109643<Error: Invalid time.|(AS) Starts in: Expression error: Unexpected < operator. (Update)

Case: Invalid End

{{Countdown
|Region=AS
|EventName=TemplateExample7
|TimeStart=2025/01/16 10:00:00 GMT+8
|TimeEnd=aaaaaaaaaaaa
}}

{{#if:2025/01/16 10:00:00 GMT+8aaaaaaaaaaaa|{{#iferror:Expression error: Unexpected < operator.||{{#ifexpr:1793109643<1736992800|(AS) Starts in: (Update)

Case: Invalid Start End

{{Countdown
|Region=AS
|EventName=TemplateExample8
|TimeStart=aaaaaaaaaaaa
|TimeEnd=aaaaaaaaaaaa
}}

{{#if:aaaaaaaaaaaaaaaaaaaaaaaa|{{#iferror:Expression error: Unexpected < operator.||{{#ifexpr:1793109643<Error: Invalid time.|(AS) Starts in: Expression error: Unexpected < operator. (Update)

Case: Blank

{{Countdown
|Region=AS
|EventName=TemplateExample9
|TimeStart=
|TimeEnd=
}}

{{#if:|{{#iferror:||{{#ifexpr:1793109643<1793109643|(AS) Starts in: (Update)

General Info

(Countdown) - Parses EventName, TimeStart and TimeEnd into a countdown, mostly used on event mentioning pages.

Utilizes the parser functions {{#time:F d, Y h:i:s A e|}} and {{#time:F d, Y|}} 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 20, 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 4, 2018 06:00, the syntax automatically assumes UTC.

@@ Line 1: / Line 1: @@
-<includeonly><div class="pp-countdown{{#if:{{{Region|}}}|-{{{Region|}}}}}"><!--
+<includeonly><div class="pp-countdown{{#if:{{{Region|}}}|-{{{Region|}}}}}{{#if:{{{Format|}}}| pp-countdown-format-{{{Format}}}| pp-countdown-format-text}}"><!--
 -->{{#vardefine:time_start_offset|{{#replace:{{{TimeStartOffset|}}}|UTC|GMT}}}}<!--
 -->{{#vardefine:time_end_offset|{{#replace:{{{TimeEndOffset|}}}|UTC|GMT}}}}<!--
+-->{{#vardefine:countdown_format|{{{Format|text}}}}}<!--
+-->{{#vardefine:countdown_padding|{{{Padding|no}}}}}<!--
+-->{{#vardefine:countdown_labels|{{{Labels|short}}}}}<!--
 --><div><!--
 -->{{#if:{{{TimeStart|}}}{{{TimeEnd|}}}<!--
@@ Line 7: / Line 10: @@
 -->||{{#ifexpr:{{#time:U|{{#time:F d, Y h:i:s A e||en}}}}<{{#time:U|{{#time:F d, Y h:i:s A e|{{#if: {{{TimeStart|}}}|{{{TimeStart}}} {{#var: time_start_offset}} | }}|en}} }}<!--
 -->|<!--
---><span data-end="toggle" data-toggle="next" data-options="no-leading-zeros {{#ifeq:{{{shorthand|yes}}}|yes|short-format}}" class="countdown hidden" style="display:none;"><!--
+--><span data-end="toggle" data-toggle="next" data-options="no-leading-zeros{{#ifeq:{{{shorthand|yes}}}|yes| short-format}}{{#ifeq:{{{Format|text}}}|colon||}}" data-format="{{{Format|text}}}" data-padding="{{{Padding|no}}}" data-labels="{{{Labels|short}}}" data-day-label="{{{DayLabel|}}}" data-hour-label="{{{HourLabel|}}}" data-minute-label="{{{MinuteLabel|}}}" data-second-label="{{{SecondLabel|}}}" class="countdown hidden" style="display:none;"><!--
     -->{{#if:{{{StartBeforeText|}}}|<span class="countdown-before">{{{StartBeforeText}}}</span>|{{#if:{{{Region|}}}|<span class="countdown-region">({{{Region}}})</span>|}}<!--
-    --> {{#if:{{{HideText|}}}||<span class="countdown-prefix">Starts in:</span>}}}}<!--
+    -->{{#ifeq:{{{Format|text}}}|boxes||{{#ifeq:{{{Format|text}}}|colon||{{#if:{{{HideText|}}}|| <span class="countdown-prefix">Starts in:</span>}}}}}}<!--
     --><span class="countdowndate" style="font-weight:bold">{{#time:F d, Y h:i:s A e|{{#if:{{{TimeStart|}}}|{{{TimeStart}}} {{#var: time_start_offset}}|}}|en}}</span><!--
     -->{{#if:{{{StartAfterText|}}}|<span class="countdown-after">{{{StartAfterText}}}</span>}}<!--
 --></span><!--
 --><span style="display:none;" class="hidden"><!--
-    --><span {{#if:{{{EndText|}}}|data-end="toggle" data-toggle="next"|data-end="remove"}} data-options="no-leading-zeros {{#ifeq:{{{shorthand|yes}}}|yes|short-format}}" class="countdown hidden" style="display:none;"><!--
+    --><span {{#if:{{{EndText|}}}|data-end="toggle" data-toggle="next"|data-end="remove"}} data-options="no-leading-zeros{{#ifeq:{{{shorthand|yes}}}|yes| short-format}}{{#ifeq:{{{Format|text}}}|colon||}}" data-format="{{{Format|text}}}" data-padding="{{{Padding|no}}}" data-labels="{{{Labels|short}}}" data-day-label="{{{DayLabel|}}}" data-hour-label="{{{HourLabel|}}}" data-minute-label="{{{MinuteLabel|}}}" data-second-label="{{{SecondLabel|}}}" class="countdown hidden" style="display:none;"><!--
        -->{{#if:{{{StartedBeforeText|{{{BeforeText|}}}}}}|<span class="countdown-before">{{{StartedBeforeText|{{{BeforeText|}}}}}}</span>|{{#if:{{{Region|}}}|<span class="countdown-region">({{{Region}}})</span>|}}<!--
-       --> {{#if:{{{HideText|}}}||<span class="countdown-prefix">{{{CountdownPrefix|Ends in:}}}</span>}}}}<!--
+       -->{{#ifeq:{{{Format|text}}}|boxes||{{#ifeq:{{{Format|text}}}|colon||{{#if:{{{HideText|}}}|| <span class="countdown-prefix">{{{CountdownPrefix|Ends in:}}}</span>}}}}}}<!--
        --><span class="countdowndate" style="font-weight:bold">{{#time:F d, Y h:i:s A e|{{#if:{{{TimeEnd|}}}|{{{TimeEnd}}} {{#var: time_end_offset}}|}}|en}}</span><!--
        -->{{#if:{{{StartedAfterText|{{{AfterText|}}}}}}|<span class="countdown-after">{{{StartedAfterText|{{{AfterText|}}}}}}</span>}}<!--
@@ Line 32: / Line 35: @@
 -->|<!--
 -->{{#ifexpr:{{#time:U|{{#time:F d, Y h:i:s A e||en}}}}<{{#time:U|{{#time:F d, Y h:i:s A e|{{#if:{{{TimeEnd|}}}|{{{TimeEnd}}} {{#var: time_end_offset}}|}}|en}}}}|<!--
-    --><span {{#if:{{{EndText|}}}|data-end="toggle" data-toggle="next"|data-end="remove"}} data-options="no-leading-zeros {{#ifeq:{{{shorthand|yes}}}|yes|short-format}}" class="countdown hidden" style="display:none;"><!--
+    --><span {{#if:{{{EndText|}}}|data-end="toggle" data-toggle="next"|data-end="remove"}} data-options="no-leading-zeros{{#ifeq:{{{shorthand|yes}}}|yes| short-format}}{{#ifeq:{{{Format|text}}}|colon||}}" data-format="{{{Format|text}}}" data-padding="{{{Padding|no}}}" data-labels="{{{Labels|short}}}" data-day-label="{{{DayLabel|}}}" data-hour-label="{{{HourLabel|}}}" data-minute-label="{{{MinuteLabel|}}}" data-second-label="{{{SecondLabel|}}}" class="countdown hidden" style="display:none;"><!--
        -->{{#if:{{{StartedBeforeText|{{{BeforeText|}}}}}}|<span class="countdown-before">{{{StartedBeforeText|{{{BeforeText|}}}}}}</span>|{{#if:{{{Region|}}}|<span class="countdown-region">({{{Region}}})</span>|}}<!--
-       --> {{#if:{{{HideText|}}}||<span class="countdown-prefix">{{{CountdownPrefix|Ends in:}}}</span>}}}}<!--
+       -->{{#ifeq:{{{Format|text}}}|boxes||{{#ifeq:{{{Format|text}}}|colon||{{#if:{{{HideText|}}}|| <span class="countdown-prefix">{{{CountdownPrefix|Ends in:}}}</span>}}}}}}<!--
        --><span class="countdowndate" style="font-weight:bold">{{#time:F d, Y h:i:s A e|{{#if:{{{TimeEnd|}}}|{{{TimeEnd}}} {{#var: time_end_offset}}|}}|en}}</span><!--
        -->{{#if:{{{StartedAfterText|{{{AfterText|}}}}}}|<span class="countdown-after">{{{StartedAfterText|{{{AfterText|}}}}}}</span>}}<!--

ReisuDesign (talk | contribs)