Date

This package contains both a flexible date/time field type Date field and a Date API that other modules can use.

The D5 and D6 versions of the Date field require the Content Construction Kit (CCK) module. The D7 version works with the core Field functionality.

Videos/Tutorials

View a free video on Date and Calendar by Karen Stevenson from Drupalize.me.

• NEW! D7.3 Calendar installation & configuration screencast from Arlin Sandbulte
• D7.2 Calendar installation & configuration screencast from Sean Effel at DrupalTherapy.com
• D6 Calendar installation & configuration screencast from Arlin Sandbulte.
• How to create an Upcoming Events list using the Date & Calendar Modules from Arlin Sandbulte
• Jan Polzer has produced a Czech screencast about how to use the Date Wizard and Calendar at Maxiorel.
• The Drupal Handbook pages are at Date/Calendar Documentation.

Important Information

Lots of the Calendar functionality comes from the Date module, so any time you update the Calendar module you should be sure you also update to the latest version of the Date module at the same time.

Date 6.2 now requires the jQuery UI module (http://drupal.org/project/jquery_ui) for the Date Popups datepicker to work!

PHP 4, 5.0, & 5.1 are no longer actively supported. If you want dates to work correctly you need to use PHP 5.2 or higher.

Be sure to read Debugging Information before reporting a problem. Going through those steps may resolve your problems and will help provide enough information to tell if this is a bug.

If you have a multi-lingual or non-English site, you need to be sure you have the right language available and that you have the Date translations on your site (try http://drupal.org/project/l10n_update for keeping them current). You may also want to look into http://drupal.org/project/l10n_client for fixing/modifying translations. Translations are handled separately from the module code, usually there is nothing the Date module can do about them directly.

D7 Notes

Note that the latest code includes two new modules, Date Repeat Field, a module to create date fields that use the Date Repeat API, and Date All Day, a module to manage handling of All Day values, including adding an All day checkbox to the widget. Both of those were formerly included in the basic Date module but have been pulled out to streamline the code and make it possible to disable them. They also serve as examples of how other modules can intervene to alter date processing.

I'm incorporating new functionality created by David Goode in a Google Summer of Code project. He added a new DateObject that handles much of the date manipulation as an extension of the PHP Date object. The D7 version now requires PHP 5.2+, so all the old crufty workarounds for PHP 4 and PHP 5.1 are gone (and good riddance!). Since we don't need to support the layer of PHP 4 workarounds, we can take full advantage of PHP 5.2 date objects.

I've added preliminary support for SQLLite and SQLServer. This is experimental and probably not stable. People who use those databases will need to help debug issues before they can really be considered supported.

Token support is not working in D7. See http://drupal.org/node/1103032 (read the issue summary at the top of that issue).

If you are using the Date Popup module on a localized site, you won't see translated values for the month names. If you want to see the translated options in the datepicker, you need the core patch at http://drupal.org/node/507502#comment-4534106. It has to be fixed in D8 and then they'll go back and fix D7, so in the meantime you will need that patch.

Related Modules

This is the beginning of a list of modules that extend Date to solve particular problems. Please check them out if the core Date functionality isn't sufficient for your needs.

Version Status

• Version 7.x-2.x is now recommended branch.
• Version 7.x-1.x was original D7 branch and should not be used.
• Version 6.x-2.x is supported and should be stable
• Version 5.x-2.x and earlier are no longer supported.

Downloads