countdown

countdown is a jQuery plugin to render countdowns. Instead of unicorns this plugin does not have any magic, but if you like countdowns to be rendered the way you want, this plugin might become your best friend.

Uber simple setup

To use the countdown plugin you need to load the current version of jQuery (tested with 1.7.2) and the javascript file of the plugin. Just add the following lines to the head of your website:

<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
<script type="text/javascript" src="/path/to/jquery.countdown.js"></script>

Then you have to initialize the plugin with your desired configuration:

$(function() {
    $('.yourCountdownContainer').countdown({
        date: "June 7, 2087 15:03:26"
    });
});

Yep, it's easy like that! Enjoy the time you saved!

Options

You can pass a set of these options to set a custom behaviour and look for the plugin.

Public plugin methods

Changelog

Version 2.2.0 - May 6, 2016

• added restart countdown api method (Thanks @scazzy)
• Fixed bower dependencies and main field

Version 2.1.0 - Oct 13, 2014

• Added time offset option to fix time differences between server and client time (#8)

Version 2.0.0 - Oct 13, 2014

• removed coffee-script dependency
• added vanilla version
• add UMD wrapper (commonJS, require.js, global)
• added support to define the end date with the data-date attribute (#14)

Version 1.0.1 - May 01, 2013

• Added callback function when the end date is reached

Version 1.0.0 - Aug 05, 2012

• Initial release

License

countdown is dual licensed under the MIT and GPL-3.0 licenses.