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

Related ecosystem projects

Projects which supplement Recurring Dates Field. See also ecosystem.

  • 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

Releases