This tag counts the time to or from a specified date.

Attributes

Time related attributes

day=number, weekday

Sets the weekday.

hour=number

Sets the hour.

iso=year-month-day

Sets the year, month and day, all at once.

mday=number

Sets the day of month.

min=number

Sets the minute.

month=number, month

Sets the month.

sec=number

Sets the second.

year=number

Sets the year.

Presentation related attributes

combined

Shows an English text describing the time period. Example: 2 days, 1 hour and 5 seconds. You may use the prec attribute to limit how precise the description should be. You can also use the month attribute if you want to see years/months/days instead of years/weeks/days.

days

Prints the number of days until the time.

dogyears

Prints the number of dog years until the time, with one decimal.

hours

Prints the number of hours until the time.

lang=ca es_CA hr cs nl en fi fr de hu it jp mi no pt ru sr si es sv

Will print the result as words in the chosen language if used together with type=string. Available languages are ca, es_CA (Catalan), hr (Croatian), cs (Czech), nl (Dutch), en (English), fi (Finnish), fr (French), de (German), hu (Hungarian), it (Italian), jp (Japanese), mi (Maori), no (Norwegian), pt (Portuguese), ru (Russian), sr (Serbian), si (Slovenian), es (Spanish) and sv (Swedish).

minutes

Prints the number of minutes until the time.

months

Prints the number of month until the time.

nowp

Returns 1 if the specified time is now, otherwise 0. How precise now should be interpreted is defined by the prec attributes. The default precision is one day.

prec=year month week day hour minute second

A modifier for the nowp and combined attributes. Sets the precision for these attributes.

seconds

Prints how many seconds until the time.

since

Counts from a time rather than towards it.

type=string number ordered

How to present the result.

weeks

Prints the number of weeks until the time.

when

Prints when the time will occur. All <date> tag attributes can be used.

years

Prints the number of years until the time.

Example

<p>I am <countdown iso=1980-06-28
since years type=string> years old.</p>

<p>There are <countdown year=2000 days>
days left until year 2000.</p>

<p>Is this a Sunday?
<br><if eval='<countdown day=sunday nowp>'>
Yes, this is a Sunday.</if>
<else>No, it isnīt.</else>

I am nineteen years old.

There are 353 days left until year 2000.

Is this a Sunday?
No, it isnīt.