Countdown
You can use the countdown variable to create commands that display the time left until a specified date. For example, you may want to countdown until a special event on stream, or until when the stream will start every day.
Usage
The countdown variable accepts two kinds of arguments: a date/time or a time
Date/Time
$(countdown
date/time
)
date/time
is the specific date/time you wish to count down to
It can accept variants of dates, but you will find it works best with dates in the format: MM DD YYYY HH:MM:SS AM/PM TZ
, MM
is the month, DD
is the day, YYYY
is the year, HH
is the hour, MM
is the minutes, SS
is the seconds, AM/PM
is AM
or PM
, and TZ
is the timezone. For a list of supported timezones, check out the time variable page.
Example Usage
$(countdown Dec 25 2015 12:00:00 AM EST)
will result with a response in this format
1 day 3 hours 20 minutes 30 seconds
Time
$(countdown
time
)
time
is the specific time you wish to count down to (the countdown resets daily)
It can accept variants of times, but you will find it works best with times in the format: HH:MM:SS AM/PM TZ
, where HH
is the hour, MM
is the minutes, SS
is the seconds, AM/PM
is AM
or PM
, and TZ
is the timezone. For a list of supported timezones, check out the time variable page.
Example Usage
$(countdown 5:00:00 PM EST)
will result with a response in this format
3 hours 20 minutes 30 seconds
Examples
Adding a command to show chatters when your special Christmas stream begins
!commands add !christmas Christmas Countdown: $(countdown Dec 25 2015 12:00:00 AM EST)
Adding a command to show chatters when your stream starts daily
!commands add !starting The stream is starting in $(countdown 5:00:00 PM EST)