This module provides a field type for storing and managing recurring dates, including single or multi-value dates, with support for standard recurrence rules and timezone handling. It also includes basic widgets and formatters for displaying recurring dates and integrating with Views.
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
Ask your assistant about Recurring Dates Field
Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works
Depends on
Dependencies of the latest stable release
- datetime_range Drupal core >=9.0.x
- system Drupal core >=9.0.x
Required by
5 tracked projects depend on this one
- Recurring Date Field Modular Widgets 8,072 sites
- LocalGov Events 480 sites
- Entity Repeat 46 sites
- OH 19 sites
- Intercept Profile