Skip to main content

Django field for storing dates without years.

Project description

Provides a Django model and form fields for dates that do not require years.

One use case is to collect birthdays without requiring the year of birth.


  • Django 1.8 - 1.11

  • Python 2.7

(Other versions may be supported, but are untested.)


pip install django-yearlessdate


The package provides two model fields, YearlessDateField and YearField.

YearlessDateField provides dropdowns for day and month, and will validate accordingly. For example, a user won’t be able to set the date to April 31st. The YearField is a very simple field that just ensures the year provided lies between 1900 and 2200. (This range will become user configurable at some point.)

Here’s an example that declares a model with a required yearless date and an optional year:

from django.db import models
from djangoyearlessdate.models import YearlessDateField, YearField

class MyModel(models.Model):
    birthday = YearlessDateField()
    year = YearField(null=True, blank=True)

The values of YearlessDateField on the model instances can be accessed like so:

>>> a = MyModel.objects.get(id=1)
>>> a
<MyModel: 4 August 2011>
>>> a.birthday.month
>>> print a.birthday
4 August

They can also be compared or sorted as would be expected, for example:

>>> m = MyModel.objects.all()
>>> m
[<MyModel: 4 August 2011>, <MyModel: 30 June 2013>]
>>> m[0].birthday > m[1].birthday
>>> m.order_by('birthday')
[<MyModel: 30 June 2013>, <MyModel: 4 August 2011>]



  1. Ensure you have a recent version of tox installed.

  2. Clone this repo.

Running tests:

From the root of this repo, run:


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-yearlessdate-1.0.tar.gz (3.7 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page