A Django app providing database and form fields for split datetime/time and pytz timezone objects.
Python
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
datetimezone_field
test/sample_project
.gitignore
README.rst
setup.py

README.rst

django-datetimezone-field

Here is how it looks like.

Written on top of django-timezone-field.

A Django app providing database and form fields for split datetime/time and pytz timezone objects.

  • Use SplitDateTimeTimeZoneField in place of forms.DateTimeField.
  • Use SplitTimeTimeZoneField in place of forms.TimeField.

The setting USE_TZ_FIELDS = True will convert all admin.ModelAdmin to use SplitDateTimeTimeZoneField for models.DateTimeField and SplitTimeTimeZoneField for models.TimeField.

Requires USE_TZ = True in settings.py

Note

If using a database that does not support timezone-aware times then the initial values of model forms will always be in the UTC timezone.

Form Field

import pytz

from django import http
from django import forms
from django.utils import timezone
from django.forms.util import to_current_timezone
from django.conf import settings

from datetimezone_field import SplitDateTimeTimeZoneField, \
    SplitTimeTimeZoneField


def index(request):

    class MyForm(forms.Form):
        a_datetime = SplitDateTimeTimeZoneField()
        a_time = SplitTimeTimeZoneField()

    tz = pytz.timezone("Australia/Sydney")
    timezone.activate(tz)
    now = to_current_timezone(timezone.now()).replace(tzinfo=tz)

    my_form = MyForm(initial={
        'a_datetime': now,
        'a_time': now.time().replace(tzinfo=now.tzinfo)
    })

    return http.HttpResponse(my_form.as_p())

Installation

  1. From pypi using pip:

    pip install django-datetimezone-field
  2. Add timezone_field and datetimezone_field to your settings.INSTALLED_APPS

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

Running sample project

  1. cd test/sample_project
  2. virtualenv sample-env
  3. source sample-env/bin/activate
  4. pip install -r requirements.txt
  5. python manage.py syncdb
  6. python manage.py runserver

TODO

  1. Unit tests

Found a Bug?

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

Credits

Built on top of Mike Fogel's django-timezone-field.