Timeframe

Click-draggable. Range-makeable. A better calendar.

The code:

new Timeframe(element, options);

Options available:

• months: The number of calendar months showing at once (default: 2).

• format: The strftime format for the dates in the input fields (default: %b %d, %Y). (With Datejs, it takes Datejs formatting.)

• weekOffset: The weekday offset (use 1 to start the week on Monday).

• startField, endField: Declare the range start and end input tags (by default, these are generated with the Timeframe).

• previousButton, todayButton, nextButton, resetButton: Declare the navigational buttons (these are also generated by default with the Timeframe).

• earliest, latest: The earliest and latest selectable dates (accepts either a Date object or a String that can be parsed with Date.parse()).

Localization:

Drop in a localized version of Datejs, and it should just work. An added bonus is that the text fields will live-parse more nicely! Just try "next tues."

Notes:

• I'm just sick of multiple date pickers on the same page.

An example:

<script type="text/javascript" charset="utf-8">
  //<![CDATA[
    new Timeframe('calendars', {
      startField: 'start',
      endField: 'end',
      earliest: new Date(),
      resetButton: 'reset' });
  //]]>
</script>

See it in action here.

Dependencies:

Timeframe requires Prototype 1.6 or higher.

Download:

Find the latest version of Timeframe on Github.

More information can be found at here.

Copyright (c) 2008 Stephen Celis, released under the MIT license.