Recurring Dates Field

Recurring Dates Field provides a field type for Drupal, handling the storage of recurring dates and integrations around them.

Looking to contribute? Start from the list of maintainer-approved issues.

• 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

Version 3.6 3.7 3.8 3.9 3.10 Drupal core 10.2 10.3 10.3 || 11 11.1 11.3 API
(Recurring Date Field internal API) 2019 RRule Library ^2 PHP Compatibility >=8.1 >=8.3 >=8.5 Stability Stable Stable Stable N/A N/A Support Security and bug fixes Unsupported Security and bug fixes New features and bug fixes Until PHP 8.2 security support ends. 3.8.x series replaces 3.7.x series since it supports the same core and PHP versions. Until PHP 8.3 security support ends or Drupal 10.3 EOL, whichever is earlier. Until PHP 8.3 security support ends or Drupal 10 EOL, whichever is earlier. Until PHP 8.3 security support ends or Drupal 11 series EOL, whichever is earlier. Until PHP 8.5 security support ends or Drupal 11 series 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, 10, 11
• 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