T Attribute

The t attribute is used to assigned a date and time in almost any format.

Note: Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the separator is a slash (/), then the American m/d/y is assumed; whereas if the separator is a dash (-) or a dot (.), then the European d-m-y format is assumed.
To avoid potential ambiguity, it’s best to use ISO 8601 (YYYY-MM-DD)

• DD-MM-YYYY HH:MM:SS
• DD.MM.YYYY HH:MM:SS
• MM/DD/YYYY HH:MM:SS
• YYYY-MM-DD HH:MM:SS

Example

[tminus t="2020-12-20 12:20:00"/]

Strtotime

PHP strtotime formats may also be used.

• +10 secs
• +1 day 2 hours

Example

[tminus t="+2 hours 23 minutes"/]

Placeholders

T(-) Countdown includes two time placeholders %this_year% and %this_easter% that can be used with strtotime to target specific holidays:

• New Years: first day of january %this_year%
• Martin Luther King, Jr. Day: january %this_year% third monday
• President’s Day: february %this_year% third monday
• Easter: %this_easter%
• Ascension Day: %this_easter% + 40 days
• Pentecost: %this_easter% + 50 days
• Memorial Day: last monday of may
• Independence Day: july 4 %this_year%
• Labor Day: september %this_year% first monday
• Columbus Day: october %this_year% second monday
• Veteran’s Day: november 11 %this_year%
• Thanksgiving Day: november %this_year% fourth thursday
• Christmas Day: december 25 %this_year%

Example

[tminus t="may 1 %this_year%"/]

Using the %this_year% and %this_easter% placeholders will automatically recalculate for next year’s date after the current years target date has past.

Other Resources

Relative Date/Time Formats in PHP

Timezone Attribute

The timezone attribute can be used to adjust the timezone if different from the default WordPress timezone set under Dashboard > Settings > General > Timezone. The value entered must be a valid timezone supported by PHP.

Example

[tminus timezone="Europe/Isle_of_Man"/]

Other Resources

List of Supported Timezones in PHP
EveryTimezone.com

ID Attribute

A unique ID for the countdown element. If the id attribute is not defined, a unique, random id will be automatically assigned.

Example

[tminus t="31-12-2012 23:59:59" id="new-years-eve"/]

Years Attribute

Replaces the default label for ‘years’.

Example

[tminus t="2020-12-31" years="Jahre"/]

Months Attribute

Replaces the default label for ‘Months’.

Example

[tminus t="2020-12-31" months="Monate"/]

Weeks Attribute

Replaces the default label for ‘Weeks’.

Example

[tminus t="2020-12-31" weeks="Wochen"/]

Days Attribute

Replaces the default label for ‘Days’.

Example

[tminus t="2020-12-31" days="Tage"/]

Hours Attribute

Replaces the default label for ‘Days’.

Example

[tminus t="2020-12-31" hours="Std."/]

Minutes Attribute

Replaces the default label for ‘Minutes’.

Example

[tminus t="2020-12-31" minutes="Mins."/]

Seconds Attribute

Replaces the default label for ‘Seconds’.

Example

[tminus t="2020-12-31" seconds="Secs."/]

Omityears Attribute

Omit the years form the date display. Use ‘true’ to hide the years. Years will be displayed by default.

Example

[tminus t="2020-12-31" omityears="true"/]

Omitmonths Attribute

Omit the months form the date display. Use ‘true’ to hide the months. Months will be displayed by default.

Example

[tminus t="2020-12-31" omitmonths="true"/]

Omitweeks Attribute

Omit the weeks form the date display. Use ‘true’ to hide the weeks. Weeks will be displayed by default.

Example

[tminus t="2020-12-31" omitweeks="true"/]

Omitseconds Attribute

Omit the seconds form the time display. Use ‘true’ to hide the seconds. Seconds will be displayed by default.

Example

[tminus t="2020-12-31 17:30:00" omitseconds="true"/]

Style Attribute

Defines the style to be used by the countdown. If not style is defined the jedi style will be used by default.

Example

[tminus t="2020-12-31" style="darth"/]

Additional Resources

T(-) Countdown Style Tests
T(-) Countdown Custom Styles

Before Attribute

Content to be displayed directly above the countdown.

Example

[tminus t="2020-12-31" before="<p>May the force...</p>"/]

After Attribute

Content to be displayed directly below the countdown.

Example

[tminus t="2020-12-31" after="<p>...be with you.</p>"/]

Launchtarget Attribute

Launchtarget Attribute
The area that the post-launch HTML will display upon launch. Valid launchtarget options include:

• tophtml – directly above the countdown
• bothtml – directly below the countdown
• countdown (default) – the entire countdown area
• countup – the countdown will start counting up
• jQuery Selector – any valid jQuery selector such as #ID or .Class

Examples

Bothtml

[tminus t="2022-12-31" launchtarget="bothtml"]
content to display on launch
[/tminus]

jQuery Selector

[tminus t="2022-12-31" launchtarget="#element_id_name"]
launch content
[/tminus]

Sizing Attributes

There are a few basic sizing attributes that can be used to define the width and height of the countdown element before and after launch.

Width Attribute

The pre-launch width in px of the countdown – default is ‘auto’.

[tminus t="2020-12-31" width="300"/]

Height Attribute

The pre-launch height in px of the countdown – default is ‘auto’.

[tminus t="2020-12-31" height="200"/]

Launchwidth Attribute

The post-launch width in px of the countdown – default is ‘auto’.

[tminus t="2020-12-31" launchwidth="300"/]

Launchheight Attribute

The post-launch height in px of the countdown – default is ‘auto’.

[tminus t="2020-12-31" launchheight="200"/]