joshdrake / django-recurrence

Utility for working with recurring dates in Django.

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