django-timezone-field 0.3.2

A Django app providing database store for pytz timezone objects.

A Django app providing database store for pytz timezone objects.

Example

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

class MyModel(models.Model):
    timezone1 = TimeZoneField()
    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.all_timezones
my_inst.save()        # 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>"

Installation

pip install django-timezone-field

Documentation

For details, see the docstring on timezone_field.fields.TimeZoneField.

Running the Tests

Using Doug Hellman’s virtualenvwrapper:

mktmpenv
pip install django-timezone-field
export DJANGO_SETTINGS_MODULE=timezone_field.test_settings
django-admin.py test timezone_field

Found a Bug?

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

Credits

Originally adapted from Brian Rosner’s django-timezones.