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 |
|---|---|---|---|---|
| Drupal core | 10.2 | 10.3 | 10.3 || 11 | 11.1 |
| API (Recurring Date Field internal API) |
2019 | |||
| RRule Library | ^2 | |||
| PHP Compatibility | >=8.1 | >=8.3 | ||
| Stability | Stable | Stable | Stable | N/A |
| Support | Security and bug fixes | Unsupported | Security and bug fixes | New features and bug fixes |
| Until PHP 8.1 security support ends or Drupal 10.2 EOL, whichever is earlier. | 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 EOL, whichever is earlier. | Until PHP 8.3 security support ends or Drupal 11.0 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]).
- 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
Short name
date_recur
Supporting organizations
Sponsors development time for 2.x
Sponsoring the development of including/excluding dates and support of pluggable occurrence backends for 1.x