Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

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

branch: develop

This branch is 0 commits ahead and 0 commits behind develop

Octocat-spinner-32 timezone_field Style fix April 12, 2014
Octocat-spinner-32 .travis.yml Update travis file for django 1.6 April 12, 2014
Octocat-spinner-32 LICENSE Add LICENSE (BSD 3-clause) April 12, 2014
Octocat-spinner-32 MANIFEST.in Add Manifest file April 12, 2014
Octocat-spinner-32 README.rst Add a default to examples September 28, 2013
Octocat-spinner-32 setup.py Raise min required django version to 1.4.2 January 26, 2013
README.rst

django-timezone-field

https://api.travis-ci.org/mfogel/django-timezone-field.png?branch=develop https://coveralls.io/repos/mfogel/django-timezone-field/badge.png?branch=develop https://pypip.in/v/django-timezone-field/badge.png https://pypip.in/d/django-timezone-field/badge.png

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

Examples

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.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>"

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.all_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>"

Installation

  1. From pypi using pip:

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

    INSTALLED_APPS = (
        ...
        timezone_field,
        ...
    )
    

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.

Something went wrong with that request. Please try again.