Recurring Dates Field provides a field type for Drupal, handling the storage of recurring dates and integrations around them.
- Provides a field type supporting dates, date ranges, and repeating dates. Dates can be single occurrence or multi-value on the field item level.
- Recurrence rules (RRule) are tried and tested with the same standard backend representation as traditional calendar software.
- Provides a simple widget. See also third-party widgets (recommended).
- Provides a simple formatter that can display the next occurrences and the repeat rule in human readable form.
- Timezones handling, including daylight saving time back-conversion (a weekly event, starting 8pm, created in summer, should be at 8pm in winter too).
- Views integration.
Drupal 7 functionality was provided by the Date Repeat (date_repeat) sub-module of the Date project.
Versions
Major version | ^3.1 (EOL) | ^3.2 (EOL) | ^3.3 (EOL) | ^3.4 | ^3.5 | ^3.6 |
---|---|---|---|---|---|---|
Drupal core | 9 only | 9 and 10 | 10.0 | 10.1 | 10.2 | |
API (Recurring Date Field internal API) |
2019 | |||||
RRule Library | ^1 | ^1 || ^2 | ^2 (v1 no longer supported due to PHP 8.1 incompatibility) | ^2 | ||
PHP Compatibility | >=7.4 | >=8.0 | >=8.1 | |||
Stability | EOL | EOL | EOL | Stable | Stable | N/A |
Support | None | Security | New features and bug fixes | |||
Until PHP 7.4 security support ends or Drupal 9 EOL, whichever is earlier. | Until PHP 8.0 security support ends or Drupal 9 EOL, whichever is earlier. | Until PHP 8.1 security support ends or Drupal 9 EOL, whichever is earlier. | Until PHP 8.1 security support ends or Drupal 10.0 EOL, whichever is earlier. | Until PHP 8.1 security support ends or Drupal 10.1 EOL, whichever is earlier. | Until PHP 8.1 security support ends or Drupal 10.2 EOL, whichever is earlier. |
View support for previous versions.
Installation and Dependencies
All installations require the use of Composer
3.x
composer require drupal/date_recur:^3.0
- Drupal core ^9
- PHP >=7.3
- Packagist libraries
Support
- Documentation for Recurring Dates Field 2.x branch — includes module configuration and API.
- Drupal.org issue queue — use search before creating new issues.
- Drupal Slack — ask questions in the Slack chat room.
Related ecosystem projects
Projects which supplement Recurring Dates Field. See also ecosystem.
- Modular Widgets — Variety pack of widgets (recommended)
- Interactive Widget — Interactive Recurring Dates Field widget (not recommended)
- Views iCal — iCal integration for Views.
- Date Recur (SS): Alternative backend for Date Recur. Allows use of simshaun/recurr library instead/simultaneous with rlanvin/php-rrule library. Provides an extra natural language interpreter.
- Calendar needs to be patched to make views created from calendar templates support recurring date fields (see #2820803: Support Recurring Dates Field in Calendar 8.x-1.x).
- Fullcalendar comes with support for recurring date fields.
Related projects
- Datetime Extras — A set of widgets, formatters, and other tools to extend the core Datetime and Datetime Range modules.
monthly calendar by Linseed Studio from the Noun Project
Supporting organizations:
Sponsors development time for 2.x
Sponsoring the development of including/excluding dates and support of pluggable occurrence backends for 1.x
Project information
- Module categories: Content Editing Experience, Site Structure
- Ecosystem: Recurring Dates Field
- 5,405 sites report using this module
- Created by Frando on , updated
- Drupal 10 is here!
Version 3.2 and later are compatible with Drupal 10
- Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.
Releases
3.5.0-beta1
released 29 January 2024
Works with Drupal: ^10.1
✓ Recommended by the project’s maintainer.
Drupal 10.2 minimum, fixes occurrence table keys.
Install:
Development version: 3.5.x-dev updated 29 Jan 2024 at 07:09 UTC