public
Description: Click-draggable. Range-makeable. A better calendar.
Homepage: http://stephencelis.com/projects/timeframe
Clone URL: git://github.com/stephencelis/timeframe.git
Click here to lend your support to: timeframe and make a donation at www.pledgie.com !
stephencelis (author)
Wed Apr 30 05:15:01 -0700 2008
commit  1a59cb18f517df60c097fe73df9a8a9cb3f16597
tree    56d33a729ff1b7dc44bf2b3388826550bf9ee8a7
parent  b816456f1ed43b416aaa4b24966dadafe70af93d
name age message
file .gitignore Sun Apr 20 19:35:00 -0700 2008 Initialization [stephencelis]
file MIT-LICENSE Sun Apr 20 19:35:00 -0700 2008 Initialization [stephencelis]
file README.markdown Sat May 03 08:11:25 -0700 2008 Docs updated [stephencelis]
file TODO Sat May 03 08:11:25 -0700 2008 Opera fixes. [stephencelis]
directory example/ Sat May 03 08:11:40 -0700 2008 Remove default values from example [stephencelis]
file timeframe.js Sat May 03 08:11:25 -0700 2008 Auto-populate from fields [stephencelis]
README.markdown

Timeframe

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

The code:

new Timeframe(element, options);

Options available:

  • calendars: 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).

  • 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()).

Notes

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

Also!!:

The startfield and endfield are parsed with Date.parse(), so feel free to use Datejs for ninja-quick date-parsing.

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.