The mobile-friendly, responsive, and lightweight jQuery date & time input picker.

pickadate v3.5.3

The mobile-friendly, responsive, and lightweight jQuery date & time input picker.

Homepage - Date picker - Time picker - API

Download v3.5.3 or git clone git://github.com/amsul/pickadate.js.git or bower install pickadate

The v3 API is significantly different from v2 (all for the greater good!). So if you’re upgrading to v3, make sure to read the changelog.

The lib folder includes the library files with a compressed folder containing the minified counter-parts. These files are minified using Grunt.

There are currently two pickers: date and time.

FileContentsSize (min & gzip)
picker.jsBase *1.76kb
picker.date.jsDate picker2.68kb
picker.time.jsTime picker1.92kb

* The base script is required for any of the pickers to function.

To support old browsers, namely IE8, also include the legacy.js file.

All themes are generated using LESS and compiled from the lib/themes-source folder into the lib/themes folder.

FileContentsSize (min & gzip)
default.cssBase default *0.49kb
default.date.cssDefault date picker0.75kb
default.time.cssDefault time picker0.35kb
classic.cssBase classic *0.39kb
classic.date.cssClassic date picker0.75kb
classic.time.cssClassic time picker0.35kb
rtl.cssRTL language stylings **0.10kb

* One and only one base stylesheet is required. Choose a theme then include the respective pickers as well.

** For languages with text flowing from right-to-left, also include the rtl.css stylesheet.

The translations live in the lib/translations folder. There are currently 39 language translations included.

Grunt ~0.4.5 is used to build the project files. To get started, clone the project and then run:

  • npm install to get the required node modules.
  • grunt --verbose to confirm you have all the dependencies.

Read the Gruntfile to see the build tasks and relative directories of the source files.

The picker themes are built using LESS with Grunt. To customize the CSS output, read the _variables.less file in the lib/themes-source folder. You can specify:

  • colors for the theme,
  • sizes for the picker,
  • media-query breakpoints,
  • and a whole bunch of other stuff.

After making any changes, run grunt less:themes to compile it into CSS.

To maintain some consistency in the sort of changes to expect with version bumps, Semantic Versioning guidelines will now be followed as closely as possible:


Constructed as such:

  • major: breaks backward compatibility (resets the minor and patch)
  • minor: new additions with backward compatibility (resets the patch)
  • patch: bug fixes and misc changes

Before opening a new issue, please search the existing Issues for anything similar – there might already be an answer to your problem. You might also wanna check out the Contributing guide.

Before contributing any code to the project, please take a look at the Contributing guide.

If you find this library useful and would like to see further development, consider supporting it.

© 2014 Amsul

Licensed under MIT