Backdrop 1.2.0 includes a built-in Date module. This includes some sub-projects of the previously add-on Date project, including "Date API", "Date Views", and "Date Popup". These projects have all been consolidated into a single module called Date. For existing sites that have upgraded from a previous version of Backdrop, this module must be enabled to use its new functionality. This can be done by visiting the modules page (admin/modules), and checking the box for Date.

If your site previously was using the contributed module version of the Date project (available from GitHub), the old module will continue functioning on your site. However, due to differences between the core Date module and the contributed Date module, it is recommended that the old module be removed from your installation to prevent problems in the future.

You can identify if your site is running the old version of Date module by checking your site's code directories. If a directory exists at /modules/date or /sites/*/modules/date, then your site is running the old Date module. The new core Date module resides at /core/modules/date and should not be changed.

Note that the core version of Date is slightly different from the contributed version. In particular:

  • Previously a utility class for manipulating dates was called dateObject. It is now called BackdropDateTime.
  • Date API, Date Views, and Date Popup are all merged into a single module. If you had previously specified dependencies[] = date_api in your module's .info file, your module should now simply depend upon Date directly with dependencies[] = date.
  • Other modules that had been a part of the Date project have been separated out into individual projects. Including:

Otherwise, the new core version of Date functions extremely similar to the contributed version and has no reduced functionality. You may switch to using the Core Date module by performing the following steps:

  1. Delete the directory containing the old module from your installation (usually /modules/date.
  2. Download and place new versions of Date Repeat, Date All Day, and Date Tools in your /modules directory if you have used any of these modules.
  3. Visit the modules page in the Backdrop UI to let Backdrop pick up the new core module location within /core/modules/date.
  4. Run update.php to have the new core module clean up its installation.

If you have never used the old contributed Date module, then no special steps are necessary. You may enable the new Date module at any time on your existing sites. The new Date module is enabled by default on new installations of Backdrop.

Introduced in branch: 
1.2.x
Introduced in version: 
1.2.0
Impacts: 
Architects, Administrators, Editors
Module developers