Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

The Final Countdown plugin for jQuery

branch: master

The Final Countdown Build Status

A simple and html agnostic date countdown plugin for jQuery

To get started, check-it out:

The ultimate countdown plugin designed to fit in any coupon, auction site or product launch. Read our Documentation and follow our Examples to see what suits your particular needs.


Click here to download the latest version

If you want to clone the repo always use the files under dist folder, they are optimized for production and development.

Install via Bower

bower install jquery.countdown

Add a script to your html:

<script src="/bower_components/jquery.countdown/dist/jquery.countdown.js"></script>

Getting started

<div id="getting-started"></div>
<script type="text/javascript">
  $('#getting-started').countdown('2015/01/01', function(event) {
    $(this).html(event.strftime('%w weeks %d days %H:%M:%S'));


Since version 2.0.0 we only support jQuery above 1.7 (including 2.0). For legacy 1.6 support please use the version 1.0.2.


Our documentation is powered by Jekyll (see gh-page branch) and hosted in GitHub Pages at


There are few ways to get started, from the most simple example to advanced, we support many different countdown styles, see wich one fits your scenario, and if anyone doesn't it's a good starting point to customize your output.

Release notes

What's new in 2.0.2

  • #22: Fix pause/continue crash with one countdown instance
  • #25: Add Bower support

What's new in 2.0.1

  • Use strict mode
  • #18: Add proper RequireJS testing

What's new in 2.0.0

  • Add the strftime formatter
  • Add support for jQuery callback style
  • Add grunt tools
  • Better docs and examples

What's new in 1.0.1 - 1.0.2

  • #15: Add AMD support
  • #10: Fix bug that call finish 2sec earlier
  • #17: Fix bug when send miliseconds has a string was not parsed

What's new in 1.0.0

  • First public release


The Final Countdown uses Grunt with convenient methods for working with the plugin. It's how we compile our code and run tests. To use it, get NodeJS, install the required dependencies as directed and then run some Grunt commands.

npm install
grunt test  # Lint code and run unit test
grunt build # Generate the release files (dev, min and zip)
grunt       # Watch for updates than test and build

This plugin is tested with QUnit, under jQuery 1.7.2 up to 2.0.3, Bootstrap 3.0 and RequireJS 2.1.9.

The functional tests were made against:

  • Chrome >= 12
  • Safari >= 5
  • Firefox >= 5.0
  • IE 7/8/9


Thanks for bug reporting and fixes:

  • Daniel Leavitt (@dleavitt)
  • Fagner Brack (@FagnerMartinsBrack)
  • Matthew Sigley (@msigley)
  • Roman Shterenzon (@romanbsd)
  • Marios (@assiotis)


Copyright (c) 2011-2014 Edson Hilios. This is a free software is licensed under the MIT License.

  • Edson Hilios. Mail me: edson (at) hilios (dot) com (dot) br
Something went wrong with that request. Please try again.