django-recurrence

django-recurrence is a utility for working with recurring dates in Django.

Functionality

Recurrence/Rule objects using a subset of rfc2445 (wraps dateutil.rrule) for specifying recurring date/times,
RecurrenceField for storing recurring datetimes in the database, and
JavaScript widget.

RecurrenceField provides a Django model field which serializes recurrence information for storage in the database.

For example - say you were storing information about a university course in your app. You could use a model like this:

import recurrence.fields

class Course(models.Model):
    title = models.CharField(max_length=200)
    start = models.TimeField()
    end = models.TimeField()
    recurrences = recurrence.fields.RecurrenceField()

You’ll notice that I’m storing my own start and end time. The recurrence field only deals with recurrences not with specific time information. I have an event that starts at 2pm. Its recurrences would be “every Friday”.

Documentation

For more information on installation and configuration see the documentation at:

https://django-recurrence.readthedocs.io/

Issues

If you have questions or have trouble using the app please file a bug report at:

https://github.com/jazzband/django-recurrence/issues

Contributions

All contributions are welcome!

It is best to separate proposed changes and PRs into small, distinct patches by type so that they can be merged faster into upstream and released quicker.

One way to organize contributions would be to separate PRs for e.g.

bugfixes,
new features,
code and design improvements,
documentation improvements, or
tooling and CI improvements.

Merging contributions requires passing the checks configured with the CI. This includes running tests and linters successfully on the currently officially supported Python and Django versions.

The test automation is run automatically with GitHub Actions, but you can run it locally with the tox command before pushing commits.

This is a Jazzband project. By contributing you agree to abide by the Contributor Code of Conduct and follow the guidelines.

Release files for django-recurrence 1.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-recurrence 1.14
File	Size	Uploaded
django_recurrence-1.14.tar.gz	102.4 kB	Dec 19, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-recurrence 1.14
File	Interpreter	ABI	Platform	Reset
django_recurrence-1.14-py3-none-any.whl 135.7 kB Dec 19, 2025	Python 3	none	any	Details

Total release size: 238.2 kB

Release files / django_recurrence-1.14.tar.gz

Download URL	django_recurrence-1.14.tar.gz
Size	102.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`154a6221bd6667c35250d9fa89bbc4792b3f1ec5dc8dff0f5872186b6df3cf76`
BLAKE2b-256 checksum How to use checksums	`c490f083ae5fae92c121ed26689c21bba68cb4651defe62bdb70200ef47ece06`
Upload date	Dec 19, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.2`

Release files / django_recurrence-1.14-py3-none-any.whl

Download URL	django_recurrence-1.14-py3-none-any.whl
Size	135.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3e7420a38c7fa2f5073598e2a4236c65a983213f30f4413618448b43514649cd`
BLAKE2b-256 checksum How to use checksums	`8508fec7dd78259512152c75e8c64ac5ba389eef55569915b190f6b798f6ff7a`
Upload date	Dec 19, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.2`