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.8 | 3.9 | 3.10 |
|---|---|---|---|
| Drupal core | 10.3 || 11 | 11.1 | 11.4 || 12.0 |
| API (Recurring Date Field internal API) |
2019 | ||
| RRule Library | ^2 | ||
| PHP Compatibility | >=8.3 | >=8.5 | |
| Stability | Stable | Stable | N/A |
| Support | Security and bug fixes | New features and bug fixes | |
| 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, 12
- PHP >=8.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 comes with support for recurring date fields.
- 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.
- An API for generating opening hours, backed by Recurring Date Field fields or other storage.
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
- Project categories: Content editing experience, Site structure
- Ecosystem: Recurring Dates Field
9,553 sites report using this module
- Created by Frando on , updated
Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.

