Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Branch: develop
152 lines (102 sloc) 4.22 KB


A Django app providing database and form fields for pytz timezone objects.


Database Field

import pytz
from django.db import models
from timezone_field import TimeZoneField

class MyModel(models.Model):
    timezone1 = TimeZoneField(default='Europe/London') # defaults supported
    timezone2 = TimeZoneField()
    timezone3 = TimeZoneField()

my_inst = MyModel(
    timezone1='America/Los_Angeles',    # assignment of a string
    timezone2=pytz.timezone('Turkey'),  # assignment of a pytz.DstTzInfo
    timezone3=pytz.UTC,                 # assignment of pytz.UTC singleton
my_inst.full_clean()  # validates against pytz.common_timezones        # values stored in DB as strings

tz = my_inst.timezone1  # values retrieved as pytz objects
repr(tz)                # "<DstTzInfo 'America/Los_Angeles' PST-1 day, 16:00:00 STD>"

Form Field

from django import forms
from timezone_field import TimeZoneFormField

class MyForm(forms.Form):
    timezone = TimeZoneFormField()

my_form = MyForm({
    'timezone': 'America/Los_Angeles',
my_form.full_clean()  # validates against pytz.common_timezones

tz = my_form.cleaned_data['timezone']  # values retrieved as pytz objects
repr(tz)                               # "<DstTzInfo 'America/Los_Angeles' PST-1 day, 16:00:00 STD>"


  1. From pypi using pip:

    pip install django-timezone-field
  2. Add timezone_field to your settings.INSTALLED_APPS:



  • 1.3
    • Drop support for django 1.6
    • Drop support for [<pytz.timezone>, <str>] format for choices kwarg for db field.
  • 1.2 (2015-02-05)
    • For form field, changed default list of accepted timezones from pytz.all_timezones to pytz.common_timezones, to match DB field behavior.
  • 1.1 (2014-10-05)
    • Django 1.7 compatibility
    • Changed format of choices kwarg to [[<str>, <str>], ...], was previously [[<pytz timezone>, <str>], ...]. Old format is still deprecated but still accepted for now; support will be removed in a future release.
    • Changed default list of accepted timezones from pytz.all_timezones to pytz.common_timezones. If you have timezones in your DB that are in pytz.all_timezones but not in pytz.common_timezones, this is a backward-incompatible change. Old behavior can be restored by specifying choices=[(tz, tz) for tz in pytz.all_timezones] in your model definition.
  • 1.0 (2013-08-04)
    • Initial release as timezone_field.

Running the Tests

  1. Install tox.

  2. From the repository root, run


    It's that simple.

Found a Bug?

To file a bug or submit a patch, please head over to django-timezone-field on github.


Originally adapted from Brian Rosner's django-timezones. The full list of contributors is available on github.

Jump to Line
Something went wrong with that request. Please try again.