Utility for working with recurring dates in Django.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 1 commit ahead, 237 commits behind django-recurrence:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
recurrence
.gitignore
LICENSE
MANIFEST.in
README.md
setup.py

README.md

Utility for working with recurring dates in Django.

  • Recurrence/Rule objects using a subset of rfc2445 (wraps dateutil.rrule) for specifying recurring date/times.
  • RecurrenceField and RecurrenceModelField for storing recurring datetimes in the database (text/one-to-one respectively)
  • 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 the below.

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. It's recurrences would be "every Friday".

RecurrenceModelField provides a django model field which is a one-to-one relations to recurrence information stored using the recurrence apps model. For this to work, you'll of course need to put the recurrence application into your INSTALLED_APPS. You'll need django.contrib.staticfiles in your INSTALLED_APPS as well, but this has been the default since Django 1.3.